RSS Feed

SharePoint Online の特定サイトでカスタムスクリプトを継続有効化する手順メモ～Azure Automation版～

Thu, 28 May 2026 10:00:00 GMT

GitHub の下記リポジトリで公開した内容を、実施観点で要点整理します。

https://github.com/kero-mio/SPOSiteCustomScriptEnabled

何をする仕組みか

この仕組みは、SharePoint Online の特定サイトに対して、カスタムスクリプト有効化を Azure Automation の Runbook で継続的に実行するためのものです。

Azure Automation 側でスケジュール実行が可能
PowerShell 7.2 向けと 5.1 向けの 2 系統のスクリプトを用意

構成図

下図は「どこで何を実行して、どこに設定が反映されるか」をシンプルに表したものです。

flowchart LR
    A["Azure Automation<br/>Runbook + スケジュール"] -->|証明書認証で接続| B["SharePoint Online<br/>管理API"]
    B --> C["対象サイト<br/>SiteUrl"]

    D["Automation 変数<br/>ClientId / TenantId / Tenant / TenantAdminUrl<br/>SiteUrl / SPOAppCertBase64 / SPOAppCertPassword"] --> A
    E["Automation 証明書<br/>*.pfx を登録"] --> A
    F["Entra ID アプリ登録<br/>API 権限付与"] --> A

図の見方:

Runbook が定期実行される実行基盤は Azure Automation
認証に必要な情報は Automation 変数と証明書に保持
Runbook が SharePoint Online 管理APIに接続し、対象サイトへ設定を適用

スクリプト構成

README では以下の 3 ファイルが中心です。

Publish_Runbook.ps1
- Azure Portal で Runbook 公開が重い場合に、Cloud Shell などから素早く公開するための補助
SPOCustomScript72.ps1
- PowerShell 7.2 向け
- PnP.PowerShell を利用
SPOCustomScript51.ps1
- PowerShell 5.1 向け
- SharePoint Online Management Shell を利用

事前準備の要点

1. Azure Automation 変数の登録

README で指定されている主要変数は次のとおりです。

ClientId
SiteUrl
SPOAppCertBase64
SPOAppCertPassword
Tenant
TenantAdminUrl
TenantId

特に証明書まわりは、自己証明書を作成し、pfx を Base64 化して Automation 変数へ登録する流れになっています。

2. Entra ID アプリ登録と権限設定

README ではアプリ登録後に SharePoint 権限を付与する手順が示されています。

代表例: Sites.FullControl.All
または Sites.Selected を使い、対象サイトに限定して FullControl を付与

Sites.Selected を使う場合は、Graph API を用いて対象サイトへの権限付与例も README に記載されています。

3. 証明書を Automation にアップロード

自己証明書作成時に作った pfx を、Automation アカウントの共有リソースの証明書へ登録します。

4. 必要モジュールを追加

README では以下のモジュールが案内されています。

PnP.PowerShell 2.12.0（主にランタイム 7.2）
SharePoint Online Management Shell 16.0.27215.12000/12001（5.1 または 7.2）

デプロイに失敗する場合の回避策として、NuGet パッケージを手動アップロードする手順も補足されています。

Runbook 作成から公開まで

README の流れは次のとおりです。

Runbook を作成し、SPOCustomScriptXX.ps1 の内容を貼り付け
テストウィンドウで実行確認
問題なければ公開

補足として、Azure Portal での公開操作が重い場合は、Publish_Runbook.ps1 を使って即時公開する方法が紹介されています。

運用時の見どころ

ターゲットサイトを変数で切り替えやすい
証明書認証ベースで運用できる
スケジュール実行で「有効化状態の維持」を自動化しやすい

上記を踏まえると、単発対応ではなく「継続的に設定状態を保ちたい」ケースに向いた構成です。

SharePoint Framework + React でカスタムWebパーツを開発するための開発環境構築メモ

Tue, 14 Nov 2023 19:03:00 GMT

昨年のメモなので、今は古い手順になると思われますが、メモのためBlogに投稿します。なお、Windows用になります。

注意点

Pythonのバージョンの依存性がSharePoint Frameworkかgulpにあるらしく、Python3.x.x 系がインストールされていると、ビルドが通らなかったりします。 Windows+VS Codeで対応している方はご注意ください。 ※こんなことならDocker作って開発環境を作成すべきだったと激しく後悔しております。今後、MSやどなたかがSharePoint Framework用のDocker環境を配布してくださることに期待。

初期インストール（Docker未使用でローカルPCに直接作成する場合）

VSCodeをインストール
Node.jsをインストール（node-v14.20.0-x64.msiがSharePoint Frameworkとの相性が良い）
Python2.7.6をインストール
VS Code から、任意のフォルダを作成し、そのフォルダを開いておく
VS Codeを開き、作成したフォルダを選択後、コンソールウィンドウを表示させ、VS Codeの統合コンソールから下記のコマンド実行する
- npm install yarn
- yo @microsoft/sharepoint

**Note: 色々聞かれるのでWizardにそってプロジェクト（WebParts）のひな形を作成していく

事前準備

configフォルダにある「serve.json」の「initialPage」を下記に変更する
- https://[テナント名].sharepoint.com/sites/[検証しているサイト名]/_layouts/workbench.aspx
.vscodeフォルダにあるlaunch.json（ローカルデバッグ用)にあるurlを下記に変更する
- https://[テナント名].sharepoint.com/sites/[検証しているサイト名]/_layouts/workbench.aspx

ビルドの仕方（ビルドエラー検出用）

gulp bundle または npm run build を実行する

初回デバッグ起動での動作確認

gulp clean
gulp trust-dev-cert

**Note: 開発で使用するローカル証明書のインストールを実施

gulp serve

**Note: 確認が終了したらコンソールから、「Ctrl+C」で中断しても良いし、そのまま起動したまま別コンソールで対応するも良し(TypeScriptの原則でOK)

動作確認（デバッグ実行の場合）

gulp clean
gulp serve --nobrowser
その後、VS Code上でF5キーを押しデバッグ実行しながら、開発を進めていく

開発を終えた後、SharePoint Onlineにデプロイする方法

コンソールから下記をたたく
- gulp clean
- gulp bundle --ship
- gulp package-solution --ship
ビルドエラーがないことを確認し、[VSCodeで開発中フォルダ]/sharepoint/solutionのフォルダにsppkgファイルが作成されることを確認する
作成したsppkgファイルをSharePoint Onlineの管理センターにある「アプリ」からアップロード（登録）する

ワンポイント：SharePoint OnlineのアプリカタログのURLは、 https://[テナント名].sharepoint.com/sites/appcatalog/_layouts/15/tenantAppCatalog.aspx/manageApps です。

後、アプリを導入したいSharePoint Onlineサイトコレクションに対し、「アプリの追加」で開発したアプリを追加し、対象サイトコレクションのページでWebパーツが利用できるようにすればOKです。

SharePoint Server 2019 ファームインストールエラーの対応

Mon, 15 May 2023 19:03:00 GMT

SharePoint Server 2019 の単一ファームインストールで、ハマったエラーがありますので、備忘録として記載致します。

事象

製品構成ウィザードまたは、psconfigコマンドで、単一ファームを作成しようとすると「System.Security.Principal.IdentityNotMappedException」が発生してしまう (SecurityTokenServiceApplicationPoolのIISアプリケーションプール作成時に発生する)

SharePointの診断ログ(%programfiles%\Common Files\Microsoft Shared\web server extensions\16\LOGS)

04/17/2023 19:00:04.97 PSCONFIG.EXE (0x2158) 0x17A4 SharePoint Foundation Claims Authentication xxxx Monitorable SPSecurityTokenServiceApplication.ProvisionLocal failed. This is expected if the IIS admin process isn't done creating IIS APPPOOL\SecurityTokenServiceApplicationPool. Retrying. System.Security.Principal.IdentityNotMappedException: ID 参照の一部またはすべてを変換できませんでした。
場所 System.Security.Principal.NTAccount.Translate(IdentityReferenceCollection sourceAccounts, Type targetType, Boolean forceSuccess)
場所 System.Security.Principal.NTAccount.Translate(Type targetType)
場所 System.Security.AccessControl.CommonObjectSecurity.ModifyAccess(AccessControlModification modification, AccessRule rule, Boolean& modified)
場所 System.Security.AccessControl.CommonObjectSecurity.AddAccessRule(AccessRule rule)
場所 Microsoft.SharePoint.Administration.Claims.SPSecurityTokenServiceCertificate.ProvisionLocal().

対応策

どうやら、AppHostSvc(Application Host Helper Service)が停止していると、発生するエラーのようです。

「services.msc」を実行し、「Application Host Helper Service」を探して、右Clickで「開始」してみてください。その後、製品構成ウィザードかpsconfigで単一ファームを作成すると問題なく作成できると思います。

Application Host Helper Serviceを開始する

所感

ファーム作成時、IISでCentral Admin Site用のサイトやアプリケーションプールを作成しようとするところでエラーが発生していました。最初は、SQL Server側のサーバーロールに、製品構成ウィザードやpsconfigを実行しているユーザーに対する権限をつけ忘れたために発生したエラーかと思いましたが、下記のサーバーロールが付与されていれば問題ないはずなので、原因の切り分けが付きづらかったです。参考になれば幸いです。

インストール実行ユーザーに対して付与すべきSQL Serverサーバーロール

2023/05/12 ブログスタート

Fri, 12 May 2023 21:48:00 GMT

けろ-みおと申します。株式会社プラティックコンサルティングに在籍中。

SharePoint Online, SharePoint Server, Azure, Power Platform を中心に構築や開発等を行っておりますが、過去のナレッジを忘れてしまうことも増えてきたため、このBlogに備忘録として記載していきたいと思いますので、よろしくお願いいたします。

主に、SharePoint関連, Teamsアドオンアプリ開発(React中心), Azure Function, Azure IoT Hub, Power Platform 等を中心に備忘録を掲載予定です。

RSSフィードで購読される場合は、 RSSフィードから購読頂けると幸いです。