一元展開 PowerShell コマンドレットを使用してアドインを管理する

Microsoft 365 グローバル管理者は、一元展開機能を使用して Office アドインをユーザーに展開できます (「 管理センターでの Office アドインの展開」を参照してください)。 Microsoft 365 管理センターを使用して Office アドインを展開するだけでなく、Microsoft PowerShell を使用することもできます。 Windows PowerShell用の O365 集中型 Add-In 展開モジュールをインストールします。

モジュールをダウンロードした後、通常のWindows PowerShell ウィンドウを開き、次のコマンドレットを実行します。

 Import-Module -Name O365CentralizedAddInDeployment

管理者の資格情報を使用して接続する

一元展開コマンドレットを使用する前に、サインインする必要があります。

1. PowerShell を起動します。

2. 会社の管理者の資格情報を使用して PowerShell に接続します。 次のコマンドレットを実行します。

Connect-OrganizationAddInService

3. 開いたサインイン プロンプトで、Microsoft 365 ユーザー 管理またはグローバル管理者の資格情報を選択または入力します。

注:

PowerShell の使用の詳細については、「PowerShell を使用して Microsoft 365 に接続する」を参照してください。

アドイン マニフェストをアップロードする

New-OrganizationAdd-In コマンドレットを実行して、ファイルの場所または URL を指定できるパスからアドイン マニフェストをアップロードします。 次の例は、 ManifestPath パラメーターの値のファイルの場所を示しています。

New-OrganizationAddIn -ManifestPath 'C:\Users\Me\Desktop\taskpane.xml' -Locale 'en-US'

次の例に示すように、 New-OrganizationAdd-In コマンドレットを実行してアドインをアップロードし、 Members パラメーターを使用してユーザーまたはグループに直接割り当てることもできます。 メンバーのメール アドレスをコンマで区切ります。

New-OrganizationAddIn -ManifestPath 'C:\Users\Me\Desktop\taskpane.xml' -Locale 'en-US' -Members  'KathyBonner@contoso.com', 'MaxHargrave@contoso.com'

Office ストアからアドインをアップロードする

New-OrganizationAddIn コマンドレットを実行して、Office ストアからマニフェストをアップロードします。

次の例では、New-OrganizationAddIn コマンドレットは、米国の場所とコンテンツ市場のアドインの AssetId を指定します。

New-OrganizationAddIn -AssetId 'WA104099688' -Locale 'en-US' -ContentMarket 'en-US'

AssetId パラメーターの値を確認するには、アドインの Office ストア Web ページの URL からコピーします。 AssetIds は常に "WA" で始まり、その後に数値が続きます。 たとえば、前の例では、WA104099688 の AssetId 値のソースは、アドインの Office ストア Web ページ URL です。 https://store.office.com/en-001/app.aspx?assetid=WA104099688

Locale パラメーターと ContentMarket パラメーターの値は同一であり、アドインをインストールしようとしている国/地域を示します。 形式は en-US、fr-FR などです。

注:

Office ストアからアップロードされたアドインは、最新の更新プログラムが Office ストアで利用可能な数日以内に自動的に更新されます。

アドインの詳細を取得する

次に示すように Get-OrganizationAddIn コマンドレットを実行して、テナントにアップロードされたすべてのアドインの詳細 (アドインの製品 ID を含む) を取得します。

Get-OrganizationAddIn

ProductId パラメーターの値を指定して Get-OrganizationAddIn コマンドレットを実行して、詳細を取得するアドインを指定します。

Get-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122

すべてのアドインと割り当てられたユーザーとグループの詳細を取得するには、次の例に示すように 、Get-OrganizationAddIn コマンドレットの出力を Format-List コマンドレットにパイプします。

foreach($G in (Get-organizationAddIn)){Get-OrganizationAddIn -ProductId $G.ProductId | Format-List}

アドインをオンまたはオフにする

アドインに割り当てられているユーザーとグループがアクセスできないようにするには、次の例に示すように、ProductId パラメーターと Enabled パラメーターを に$false設定して Set-OrganizationAddIn コマンドレットを実行します。

Set-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Enabled $false

アドインを有効に戻すには、 Enabled パラメーターを に設定して同じコマンドレットを $true実行します。

Set-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Enabled $true

アドインからユーザーを追加または削除する

特定のアドインにユーザーとグループを追加するには、ProductId、Add、および Members パラメーターを使用して Set-OrganizationAddInAssignments コマンドレットを実行します。 メンバーのメール アドレスをコンマで区切ります。

Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Add -Members 'KathyBonner@contoso.com','sales@contoso.com'

ユーザーとグループを削除するには、 Remove パラメーターを使用して同じコマンドレットを実行します。

Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Remove -Members 'KathyBonner@contoso.com','sales@contoso.com'

テナント上のすべてのユーザーにアドインを割り当てるには、 AssignToEveryone パラメーターを使用して同じコマンドレットを実行し、値を に $true設定します。

Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -AssignToEveryone $true

すべてのユーザーにアドインを割り当てず、以前に割り当てたユーザーとグループに戻すには、同じコマンドレットを実行し、その値を に$false設定して AssignToEveryone パラメーターをオフにすることができます。

Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -AssignToEveryone $false

アドインを更新する

マニフェストからアドインを更新するには、次の例に示すように、ProductId、ManifestPath、および Locale パラメーターを使用して Set-OrganizationAddIn コマンドレットを実行します。

Set-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -ManifestPath 'C:\Users\Me\Desktop\taskpane.xml' -Locale 'en-US'

注:

Office ストアからアップロードされたアドインは、最新の更新プログラムが Office ストアで利用可能な数日以内に自動的に更新されます。

アドインを削除する

アドインを削除するには、次の例に示すように、ProductId パラメーターを使用して Remove-OrganizationAddIn コマンドレットを実行します。

Remove-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122

各コマンドレットの詳細なヘルプを取得する

Get-help コマンドレットを使用して、各コマンドレットの詳細なヘルプを確認できます。 たとえば、次のコマンドレットは、Remove-OrganizationAddIn コマンドレットに関する詳細情報を提供します。

Get-help Remove-OrganizationAddIn -Full