Gerenciar o Teams com o Microsoft Teams PowerShell

• Aplica-se a:

  Microsoft Teams

Este artigo mostra como usar o Microsoft Teams PowerShell para gerenciar o Teams.

Use essas diretrizes em conjunto com a referência de cmdlet do Microsoft Teams.

Para gerenciar o Teams no centro de administração do Teams, consulte Gerenciar o Teams com o Azure Cloud Shell.

Criar e gerenciar equipes usando o PowerShell

Os cmdlets para criar e gerenciar equipes estão no módulo do Microsoft Teams PowerShell.

As equipes são apoiadas por grupos de Office 365, portanto, quando você cria uma equipe, você cria um grupo. Há um conjunto de cmdlets fornecidos para operar na equipe principal e suas configurações (new-team, , get-team, , set-teamgerenciando usuários de equipe (add-teamuser, remove-teamuser), bem como cmdlets para gerenciar os canais da equipe (new-teamchannel, remove-teamchannel). Todos esses cmdlets podem ser executados como usuários finais, mas eles funcionarão apenas nas equipes das quais você possui ou é membro. Se você for um Administração global ou administrador do Teams, poderá atuar em todas as equipes da sua organização.

New-Team -DisplayName "Contoso Marketing" -Description "Collaboration space for Contoso's Marketing department"

Nota

O GroupId usado nos cmdlets do módulo do Microsoft Teams PowerShell é o mesmo que a propriedade Identity retornada no Get-UnifiedGroup módulo do Exchange PowerShell.

Gerenciar o Teams com o Azure Cloud Shell

Cloud Shell é um shell interativo, autenticado e acessível pelo navegador que permite gerenciar seus recursos. Para obter mais informações sobre Cloud Shell, consulte Azure Cloud Shell.

Para acessar o Azure Cloud Shell e usar o PowerShell para gerenciar o Teams, entre no centro de administração do Teams.

1. Selecione o ícone Cloud Shell no canto superior direito.

   

2. Quando solicitado, escolha PowerShell.

   

3. Execute o seguinte comando para iniciar uma sessão do Teams PowerShell:

   Connect-MicrosoftTeams
   

Depois de concluir essas etapas, você estará pronto para executar comandos do Teams PowerShell.

Importante

Se você quiser usar cmdlets Cs*, primeiro precisará se conectar ao Teams usando o Connect-MicrosoftTeams -UseDeviceAuthentication comando.

Gerenciar políticas por meio do PowerShell

Encontre os cmdlets para gerenciar políticas no módulo de cmdlet do Microsoft Teams.

Uma política é um grupo de configurações que pode ser aplicada granularmente a usuários individuais. Cada tipo de política tem seu próprio conjunto de cmdlets para criar, exibir, excluir e atualizar as próprias políticas e atribuir essas políticas aos usuários. A estrutura geral é:

• Comandos GET (por exemplo, Get-CsTeamsMeetingPolicy): retorna os documentos de política disponíveis para você atribuir em sua organização, incluindo as políticas criadas pela Microsoft para você usar, bem como as políticas personalizadas que você criou.

  • Para localizar apenas as políticas personalizadas que você criou em sua organização, use -Filter "tag:*".

• Novos comandos (por exemplo, New-CsTeamsMeetingPolicy): cria novas políticas para sua organização atribuir aos usuários em sua organização. Nem todas as políticas dão suporte à criação de políticas personalizadas. Muitas vezes, isso é para garantir que as políticas que você usa em sua organização tenham uma combinação de configurações com suporte.

• Comandos SET (por exemplo, Set-CsTeamsMeetingPolicy): define valores específicos em uma determinada política. Algumas políticas não têm comandos SET disponíveis ou contêm parâmetros que não podem ser personalizados na política. As descrições do PowerShell informam quais parâmetros não podem ser personalizados.

  • Para editar a política que, por padrão, será atribuída aos usuários da sua organização que não têm uma política personalizada atribuída, execute Set-Cs<PolicyName> -Identity Global.

• Comandos REMOVE (por exemplo, Remove-CsTeamsMeetingPolicy): exclui uma política personalizada que foi criada em seu locatário. Se você excluir uma política personalizada atribuída a pelo menos um usuário em sua organização, esse usuário retornará à política global.

  • Você não pode realmente remover a política global em sua organização, mas se quiser redefinir a política global em sua organização para as configurações padrão fornecidas pela Microsoft, execute Remove-Cs<PolicyName> -Identity Global.

• Comando GRANT (por exemplo, Grant-CsTeamsMeetingPolicy): atribui uma política a um determinado usuário.

  • Para remover uma atribuição de política personalizada e fazer com que o usuário volte à política padrão em sua organização, execute Grant-Cs<PolicyName> -Identity <User Identity> -PolicyName $null.

Ponta

Nem todas as políticas permitem que políticas personalizadas sejam criadas e algumas políticas têm configurações que você não pode personalizar (para que você possa exibir a configuração, mas não possa definir um valor personalizado durante set- e new-). A documentação de cada cmdlet chama se os parâmetros estão disponíveis para uso pelos clientes.

Parâmetros comuns:

• Identidade: para Get-, Set-, New-e Remove-, o parâmetro Identity sempre se referirá a uma instância de política específica. Para Grant, o parâmetro Identity refere-se a um objeto de usuário específico a quem a política está sendo aplicada.

Gerenciar configurações por meio do PowerShell

Encontre os cmdlets para gerenciar sua configuração no módulo de cmdlet do Microsoft Teams.

As configurações são buckets de configurações mantidas no serviço que não podem ser especificadas em um nível de usuário. As configurações sempre se aplicam em toda a organização. Sua configuração global é a única configuração eficaz em sua organização. Cada tipo de configuração vem com dois cmdlets primários:

• Get-Cs<ConfigurationName> (por exemplo, Get-CsTeamsClientConfiguration):

• Comandos SET (por exemplo, Set-CsTeamsClientConfiguration): defina propriedades na configuração desse tipo. Especifique os parâmetros que você deseja modificar.

  Nota

  Você pode fazer referência à configuração que está modificando de duas maneiras: especificando -Identity Global ou executando Get-Cs<ConfigurationName> | Set-Cs<ConfigurationName>.

O que cada função de administrador pode fazer?

Leia Usar funções de administrador do Microsoft Teams para gerenciar o Teams para entender quais funções de administrador podem executar cada cmdlet do PowerShell.

Tópicos relacionados

Instalando o Teams PowerShell

Notas de versão do Teams PowerShell

Referência de cmdlet Teams

Usar as funções de administrador para gerenciar o Teams