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

Como administrador do Office 365, é possível implantar suplementos do Office para usuários pelo recurso Implantação Centralizada. Confira Implantar suplementos do Office no Centro de administração do Office 365. Além de implantar suplementos do Office pelo Office 365 admin center, também é possível usar o Microsoft PowerShell. Baixe os cmdlets do PowerShell para Implantação Centralizada do Microsoft Download Center.

O que você deseja fazer?

Conectar-se usando as credenciais de administrador

Carregar um manifesto de suplemento

Carregar um suplemento da Office Store

Ver os detalhes de um suplemento

Ativar ou desativar um suplemento

Adicionar ou remover usuários de um suplemento

Atualizar um suplemento

Excluir um suplemento

Ver a ajuda detalhada de cada cmdlet

Conectar-se usando as credenciais de administrador

Para usar os cmdlets da Implantação Centralizada, você deve se conectar.

  1. Inicie o PowerShell.

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

    Connect-OrganizationAddInService
  3. Na página Inserir Credenciais, insira as credenciais de administrador global do Office 365. Se preferir, insira as credenciais diretamente no cmdlet.

    Execute o cmdlet a seguir especificando as credenciais de administrador da empresa como um objeto PSCredential.

    $secpasswd = ConvertTo-SecureString “MyPassword” -AsPlainText -Force
    $mycredentials = New-Object System.Management.Automation.PSCredential (“serviceaccount@contoso.com”, $secpasswd)
    Connect-OrganizationAddInService -Credential $mycredentials

Observação : Saiba mais sobre como usar o PowerShell em Conectar-se ao Office 365 PowerShell.

Carregar um manifesto de suplemento

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

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

Também é possível executar o cmdlet New-OrganizationAdd-In para carregar um suplemento e atribuí-lo diretamente a usuários ou grupos usando o parâmetro Members, como mostra o 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 a AssetId de um suplemento para um local e mercado de conteúdo dos Estados Unidos.

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

Para determinar o valor do parâmetro AssetId, é possível copiá-lo na URL da página da Office Store do suplemento. As AssetIds sempre começam com "WA" seguidas de um número. Por exemplo, no exemplo anterior, a origem do valor de WA104099688 da AssetId é a URL da página da Office Store do suplemento: https://store.office.com/en-001/app.aspx?assetid=WA104099688.

Os valores dos parâmetros Locale e ContentMarket são idênticos e indicam a região ou o país do qual você está tentando instalar o suplemento. O formato é en-US, pt-BR 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 disponibilizada na Office Store.

Ver os detalhes de um suplemento

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

Get-OrganizationAddIn

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

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

Para ver os detalhes completos de todos os suplementos, além dos usuários e grupos atribuídos, redirecione a saída do cmdlet Get-OrganizationAddIn para o cmdlet Format-List, como mostra o exemplo a seguir.

Get-OrganizationAddIn |Format-List

Ativar ou desativar um suplemento

Para desativar um suplemento para que usuários e grupos atribuídos a ele não tenham mais acesso, execute o cmdlet Set-OrganizationAddIn com os parâmetros ProductId e Enabled definidos como $false, como mostra o exemplo a seguir.

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

Para ativar novamente o suplemento, execute o mesmo cmdlet com o parâmetro Enabled 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 Remove.

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 os usuários e revertê-lo aos usuários e grupos atribuídos previamente, execute o mesmo cmdlet e desative o parâmetro AssignToEveryone definindo o respectivo valor como $false.

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

Atualizar um suplemento

Para atualizar o suplemento de um manifesto, execute o cmdlet Set-OrganizationAddIn com os parâmetros ProductId, ManifestPath e Locale, como mostra o 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 disponibilizada na Office Store.

Excluir um suplemento

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

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

Ver a ajuda detalhada de cada cmdlet

Para ver a ajuda detalhada de cada cmdlet, use o cmdlet Get-help. Por exemplo, o cmdlet a seguir fornece informações detalhadas sobre o cmdlet Remove-OrganizationAddIn.

Get-help Remove-OrganizationAddIn -Full
Expanda suas habilidades
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×