次の方法で共有

一元展開 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
  1. 開いたサインイン プロンプトで、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