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

Enquanto administrador de utilizadores do Microsoft 365, pode implementar Suplementos do Office para utilizadores através da funcionalidade Implementação Centralizada (consulte Implementar Suplementos do Office no centro de administração). Além de implementar Suplementos do Office através do centro de administração do Microsoft 365, também pode utilizar o Microsoft PowerShell. Instale o Módulo de Implementação de Add-In Centralizado do O365 para Windows PowerShell.

Depois de transferir o módulo, abra uma janela normal do Windows PowerShell e execute o seguinte cmdlet:

 Import-Module -Name O365CentralizedAddInDeployment

Ligar com as suas credenciais de administrador

Antes de poder utilizar os cmdlets de Implementação Centralizada, tem de iniciar sessão.

1. Inicie o PowerShell.

2. Ligue-se ao PowerShell com as suas credenciais de Administrador de Utilizador . Execute o seguinte cmdlet.

Connect-OrganizationAddInService

3. No pedido de início de sessão que é aberto, selecione ou introduza as suas credenciais de Administrador de Utilizador do Microsoft 365.

Observação

Para obter mais informações sobre como utilizar o PowerShell, consulte Ligar ao Microsoft 365 com o PowerShell.

Carregar um manifesto de suplemento

Execute o cmdlet New-OrganizationAdd-In para carregar um manifesto de suplemento a partir de um caminho, que pode ser uma localização de ficheiro ou UM URL. O exemplo seguinte mostra uma localização de ficheiro para o valor do parâmetro ManifestPath .

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

Também pode executar o cmdlet New-OrganizationAdd-In para carregar um suplemento e atribuí-lo diretamente a utilizadores ou grupos através do parâmetro Membros , conforme mostrado no exemplo seguinte. Separe os endereços de e-mail 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 a partir da Loja Office

Execute o cmdlet New-OrganizationAddIn para carregar um manifesto a partir da Loja Office.

No exemplo seguinte, o cmdlet New-OrganizationAddIn especifica o AssetId para um suplemento para uma localização e mercado de conteúdos dos Estados Unidos.

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

Para determinar o valor do parâmetro AssetId , pode copiá-lo do URL da página Web da Loja Office para o suplemento. Os AssetIds começam sempre com "WA" seguido de um número. Por exemplo, no exemplo anterior, a origem do valor AssetId de WA104099688 é o URL da página Web da Loja Office 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 a partir do qual está a tentar instalar o suplemento. O formato é en-US, fr-FR e assim sucessivamente.

Observação

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

Obter detalhes de um suplemento

Execute o cmdlet Get-OrganizationAddIn , conforme mostrado abaixo, para obter detalhes de todos os suplementos carregados para o inquilino, incluindo o ID de produto de um suplemento.

Get-OrganizationAddIn

Execute o cmdlet Get-OrganizationAddIn com um valor para o parâmetro ProductId para especificar para que suplemento pretende obter os detalhes.

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

Para obter detalhes completos de todos os suplementos e os utilizadores e grupos atribuídos, encaminhe a saída do cmdlet Get-OrganizationAddIn para o cmdlet Format-List, conforme mostrado no exemplo seguinte.

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

Ativar ou desativar um suplemento

Para desativar um suplemento para que os utilizadores e grupos atribuídos ao mesmo deixem de ter acesso, execute o cmdlet Set-OrganizationAddIn com o parâmetro ProductId e o parâmetro Ativado definido $falsecomo , conforme mostrado no exemplo seguinte.

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

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

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

Adicionar ou remover utilizadores de um suplemento

Para adicionar utilizadores 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 e-mail dos membros com uma vírgula.

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

Para remover utilizadores e grupos, execute o mesmo cmdlet com 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 utilizadores no inquilino, execute o mesmo cmdlet com 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 todas as pessoas e reverter para os utilizadores e grupos atribuídos anteriormente, pode executar o mesmo cmdlet e desativar o parâmetro AssignToEveryone ao definir o respetivo valor como $false.

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

Atualizar um suplemento

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

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

Observação

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

Excluir um complemento

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

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

Obter ajuda detalhada para cada cmdlet

Pode ver ajuda detalhada para cada cmdlet com o cmdlet Get-help. Por exemplo, o cmdlet seguinte fornece informações detalhadas sobre o cmdlet Remove-OrganizationAddIn.

Get-help Remove-OrganizationAddIn -Full