Administrar Teams con Microsoft Teams PowerShell

En este artículo se muestra cómo usar Microsoft Teams PowerShell para administrar Teams.

Use esta guía junto con la referencia de cmdlets de Microsoft Teams.

Para administrar Teams en el Centro de administración de Teams, consulte Administrar Teams con Azure Cloud Shell.

Crear y administrar equipos con PowerShell

Los cmdlets para crear y administrar equipos se encuentran en el módulo de Microsoft Teams PowerShell.

Teams cuenta con el respaldo de Office 365 Grupos, por lo que al crear un equipo, se crea un grupo. Se proporciona un conjunto de cmdlets para operar en el equipo principal y su configuración (, , ), la administración de usuarios del equipo (add-teamuser, remove-teamuser), así como cmdlets para administrar los canales del equipo (new-teamchannel, remove-teamchannel). set-teamget-teamnew-team Todos estos cmdlets se pueden ejecutar como usuarios finales, pero solo funcionarán en los equipos de su propiedad o de los que sea miembro. Si es un Administración global o administrador de Teams, podrá actuar en todos los equipos de su organización.

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

Nota

El GroupId usado en los cmdlets del módulo PowerShell de Microsoft Teams es el mismo que la propiedad Identity devuelta por Get-UnifiedGroup en el módulo de Exchange PowerShell.

Administrar Teams con Azure Cloud Shell

Cloud Shell es un shell interactivo, autenticado y accesible para el explorador que le permite administrar los recursos. Para obtener más información sobre Cloud Shell, vea Azure Cloud Shell.

Para obtener acceso a Azure Cloud Shell y usar PowerShell para administrar Teams, inicie sesión en el Centro de administración de Teams.

  1. Seleccione el icono Cloud Shell en la esquina superior derecha.

    Captura de pantalla del encabezado del Centro de administración de Teams con Cloud Shell icono.

  2. Cuando se le solicite, elija PowerShell.

    Captura de pantalla del aviso de Azure Cloud Shell.

  3. Ejecute el siguiente comando para iniciar una sesión de PowerShell de Teams:

    Connect-MicrosoftTeams
    

Cuando haya completado estos pasos, estará listo para ejecutar los comandos de PowerShell de Teams.

Importante

Si desea usar cmdlets Cs*, primero debe conectarse a Teams mediante el Connect-MicrosoftTeams -UseDeviceAuthentication comando.

Administrar directivas a través de PowerShell

Busque los cmdlets para administrar directivas en el módulo de cmdlets de Microsoft Teams.

Una directiva es un grupo de opciones de configuración que se pueden aplicar pormenorizadamente a usuarios individuales. Cada tipo de directiva tiene su propio conjunto de cmdlets para crear, ver, eliminar y actualizar las propias directivas y, después, asignar esas directivas a los usuarios. La estructura general es la siguiente:

  • Comandos GET (por ejemplo, Get-CsTeamsMeetingPolicy): Devuelve los documentos de directivas que está disponible para asignar en su organización, incluidas las directivas creadas por Microsoft para su uso, así como las directivas personalizadas que ha creado.

    • Para buscar solo las directivas personalizadas que ha creado en su organización, use -Filter "tag:*".
  • Comandos NUEVOS (por ejemplo, New-CsTeamsMeetingPolicy): crea nuevas directivas para que la organización las asigne a los usuarios de la organización. No todas las directivas admiten la creación de directivas personalizadas. A menudo, esto es para asegurarse de que las directivas que usa en su organización tienen una combinación compatible de opciones de configuración.

  • Comandos SET (por ejemplo, Set-CsTeamsMeetingPolicy): establece valores concretos en una directiva determinada. Algunas directivas no tienen comandos SET disponibles o contienen parámetros que no se pueden personalizar en la directiva. Las descripciones de PowerShell indican qué parámetros no se pueden personalizar.

    • Para editar la directiva que se asignará de forma predeterminada a los usuarios de la organización que no tienen asignada una directiva personalizada, ejecute Set-Cs<PolicyName> -Identity Global.
  • Comandos REMOVE (por ejemplo, Remove-CsTeamsMeetingPolicy): elimina una directiva personalizada que se ha creado en el espacio empresarial. Si elimina una directiva personalizada asignada a al menos un usuario de su organización, dicho usuario volverá a la directiva global.

    • En realidad no puede quitar la directiva global de su organización, pero si quiere restablecer la directiva global de su organización a la configuración predeterminada proporcionada por Microsoft, ejecute Remove-Cs<PolicyName> -Identity Global.
  • Comando GRANT (por ejemplo, Grant-CsTeamsMeetingPolicy): Asigna una directiva a un usuario determinado.

    • Para quitar una asignación de directiva personalizada y hacer que el usuario vuelva a la directiva predeterminada de su organización, ejecute Grant-Cs<PolicyName> -Identity <User Identity> -PolicyName $null.

Propina

No todas las directivas permiten la creación de directivas personalizadas y algunas directivas tienen configuraciones que no puede personalizar (por lo que puede ver la configuración, pero no puede establecer un valor personalizado durante set- y new-). La documentación de cada cmdlet indica si los parámetros están disponibles para su uso por parte de los clientes.

Parámetros comunes:

  • Identidad: Para Get-, Set-, New-, y Remove-, el parámetro Identity siempre hará referencia a una instancia de directiva específica. Para Grant, el parámetro Identity hace referencia a un objeto de usuario específico al que se aplica la directiva.

Administrar configuraciones a través de PowerShell

Busque los cmdlets para administrar la configuración en el módulo de cmdlets de Microsoft Teams.

Las configuraciones son cubos de configuraciones que se mantienen en el servicio y que no se pueden especificar a nivel de usuario. La configuración siempre se aplica en toda la organización. La configuración global es la única configuración eficaz de su organización. Cada tipo de configuración incluye dos cmdlets principales:

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

  • Comandos SET (por ejemplo, Set-CsTeamsClientConfiguration): establecer propiedades en la configuración de ese tipo. Especifique los parámetros que desea modificar.

    Nota

    Puede hacer referencia a la configuración que está modificando de una de estas dos maneras: especificando -Identity Global o ejecutando Get-Cs<ConfigurationName> | Set-Cs<ConfigurationName>.

¿Qué puede hacer cada rol de administrador?

Lea Usar roles de administrador de Microsoft Teams para administrar Teams para comprender qué roles de administrador pueden ejecutar cada cmdlet de PowerShell.

Instalar PowerShell de Teams

Notas de la versión de PowerShell de Teams

Referencia de cmdlet para Teams

Usar roles de administrador para administrar Teams