Usar os cmdlets do PowerShell de Implantação Centralizada para gerenciar suplementos

Como administrador global do Microsoft 365, você pode implantar suplementos do Office em usuários por meio do recurso de Implantação Centralizada (confira Implantar Suplementos do Office no centro de administração). Além de implantar suplementos do Office por meio do Centro de administração do Microsoft 365, você também pode usar o Microsoft PowerShell. Instale o Módulo de Implantação do Add-In Centralizado O365 para Windows PowerShell.

Depois de baixar o módulo, abra uma janela de Windows PowerShell regular e execute o seguinte cmdlet:

 Import-Module -Name O365CentralizedAddInDeployment

Conectar-se usando suas credenciais de administrador

Antes de poder usar os cmdlets de Implantação Centralizada, você precisa entrar.

1. Inicie o PowerShell.

2. Conecte-se ao PowerShell usando as credenciais de administrador da empresa. Execute o cmdlet a seguir.

Connect-OrganizationAddInService

3. No prompt de entrada que abre, selecione ou insira suas credenciais de Administração de usuário do Microsoft 365 ou administrador global.

Observação

Para obter mais informações sobre como usar o PowerShell, consulte Conectar-se ao Microsoft 365 com o PowerShell.

Carregar um manifesto de suplemento

Execute o cmdlet New-OrganizationAdd-In para carregar um manifesto de suplemento de um caminho, que pode ser um local de arquivo ou URL. O exemplo a seguir mostra um local de arquivo para o valor do parâmetro ManifestPath .

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

Você também pode executar o cmdlet New-OrganizationAdd-In para carregar um suplemento e atribuí-lo a usuários ou grupos diretamente usando o parâmetro Membros , conforme mostrado no exemplo a seguir. Separe os endereços de email dos membros com uma vírgula.

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

Carregar um suplemento da Office Store

Execute o cmdlet New-OrganizationAddIn para carregar um manifesto da Office Store.

No exemplo a seguir, o cmdlet New-OrganizationAddIn especifica o AssetId para um suplemento para um Estados Unidos local e mercado de conteúdo.

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

Para determinar o valor do parâmetro AssetId , você pode copiá-lo da URL da página da Web da Office Store para o suplemento. Os AssetIds sempre começam com "WA" seguido por um número. Por exemplo, no exemplo anterior, a origem do valor AssetId de WA104099688 é a URL da página da Web do Office Store para o suplemento: https://store.office.com/en-001/app.aspx?assetid=WA104099688.

Os valores do parâmetro Locale e do parâmetro ContentMarket são idênticos e indicam o país/região do qual você está tentando instalar o suplemento. O formato é en-US, fr-FR e assim por diante.

Observação

Os suplementos carregados da Office Store serão atualizados automaticamente dentro de alguns dias após a atualização mais recente estar disponível na Office Store.

Obter detalhes de um suplemento

Execute o cmdlet Get-OrganizationAddIn conforme mostrado abaixo para obter detalhes de todos os suplementos carregados no locatário, incluindo a ID do produto de um suplemento.

Get-OrganizationAddIn

Execute o cmdlet Get-OrganizationAddIn com um valor para o parâmetro ProductId para especificar para qual suplemento você deseja recuperar detalhes.

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

Para obter detalhes completos de todos os suplementos mais os usuários e grupos atribuídos, pipe a saída do cmdlet Get-OrganizationAddIn para o cmdlet Format-List, conforme mostrado no exemplo a seguir.

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

Ativar ou desativar um suplemento

Para desativar um suplemento para que os usuários e grupos atribuídos a ele não tenham mais acesso, execute o cmdlet Set-OrganizationAddIn com o parâmetro ProductId e o parâmetro Habilitado definido como $false, conforme mostrado no exemplo a seguir.

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

Para ativar um suplemento, execute o mesmo cmdlet com o parâmetro Habilitado definido como $true.

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

Adicionar ou remover usuários de um suplemento

Para adicionar usuários e grupos a um suplemento específico, execute o cmdlet Set-OrganizationAddInAssignments com os parâmetros ProductId, Add e Members . Separe os endereços de email dos membros com uma vírgula.

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

Para remover usuários e grupos, execute o mesmo cmdlet usando o parâmetro Remover .

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

Para atribuir um suplemento a todos os usuários no locatário, execute o mesmo cmdlet usando o parâmetro AssignToEveryone com o valor definido como $true.

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

Para não atribuir um suplemento a todos e reverter aos usuários e grupos atribuídos anteriormente, você pode executar o mesmo cmdlet e desativar o parâmetro AssignToEveryone definindo seu valor como $false.

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

Atualizar um suplemento

Para atualizar um suplemento de um manifesto, execute o cmdlet Set-OrganizationAddIn com os parâmetros ProductId, ManifestPath e Locale , conforme mostrado no exemplo a seguir.

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

Observação

Os suplementos carregados da Office Store serão atualizados automaticamente dentro de alguns dias após a atualização mais recente estar disponível na Office Store.

Excluir um complemento

Para excluir um suplemento, execute o cmdlet Remove-OrganizationAddIn com o parâmetro ProductId , conforme mostrado no exemplo a seguir.

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

Obter ajuda detalhada para cada cmdlet

Você pode examinar a ajuda detalhada para cada cmdlet usando o cmdlet Get-help. Por exemplo, o cmdlet a seguir fornece informações detalhadas sobre o cmdlet Remove-OrganizationAddIn.

Get-help Remove-OrganizationAddIn -Full