Asignación de directivas por usuario Skype Empresarial en línea con PowerShell para Microsoft 365

  • Artículo

Este artículo afecta tanto a Office 365 Enterprise como a Microsoft 365 Enterprise

El uso de PowerShell para Microsoft 365 es una manera eficaz de asignar la configuración de comunicación por usuario con directivas de Skype Empresarial Online.

Preparación para ejecutar los comandos de PowerShell

Siga estas instrucciones para configurarse para ejecutar los comandos (omita los pasos que ya ha completado):

Nota:

El conector en línea del cliente de Skype® Empresarial actualmente forma parte del módulo más reciente de Windows PowerShell de Teams. Si usa la versión pública más reciente de Teams PowerShell, no es necesario que instale el conector en línea de cliente de Skype® Empresarial.

  1. Instale el Módulo de PowerShell de Teams.

  2. Abra el símbolo del sistema de Windows PowerShell y ejecute los siguientes comandos:

    Import-Module MicrosoftTeams
Connect-MicrosoftTeams

    Cuando se le solicite, escriba el nombre y la contraseña de la cuenta de administrador de Skype Empresarial Online.

Actualización de la configuración de comunicación externa para una cuenta de usuario

Supongamos que desea cambiar la configuración de comunicación externa en una cuenta de usuario. Por ejemplo, quiere permitir que Alex se comunique con los usuarios federados (EnableFederationAccess es igual a True), pero no con los usuarios de Windows Live (EnablePublicCloudAccess es igual a False). Para ello, debe hacer dos cosas:

  1. Buscar una directiva de acceso externo que cumpla nuestros criterios.

  2. Asignar esa directiva de acceso externo a Alex.

¿Cómo se determina qué directiva de acceso externo se va a asignar a Alex? El siguiente comando devuelve todas las directivas de acceso externo donde EnableFederationAccess se establece en True y EnablePublicCloudAccess se establece en False:

Get-CsExternalAccessPolicy -Include All| Where-Object {$_.EnableFederationAccess -eq $True -and $_.EnablePublicCloudAccess -eq $False}

A menos que haya creado instancias personalizadas de ExternalAccessPolicy, ese comando devuelve una directiva que cumple nuestros criterios (FederationOnly). Aquí le mostramos un ejemplo:

Identity                          : Tag:FederationOnly
Description                       :
EnableFederationAccess            : True
EnableXmppAccess                  : False
EnablePublicCloudAccess           : False
EnablePublicCloudAudioVideoAccess : False
EnableOutsideAccess               : True

Ahora que sabe qué directiva asignar a Alex, podemos asignarla mediante el cmdlet Grant-CsExternalAccessPolicy . Aquí le mostramos un ejemplo:

Grant-CsExternalAccessPolicy -Identity "Alex Darrow" -PolicyName "FederationOnly"

Asignar una directiva es sencillo: puede especificar la identidad del usuario y el nombre de la directiva que se va a asignar.

Y cuando se trata de directivas y asignaciones de directivas, no se limita a trabajar con cuentas de usuario de una en una. Por ejemplo, supongamos que necesita una lista de todos los usuarios que tienen permiso para comunicarse con los socios federados y los usuarios de Windows Live. Ya sabemos que a esos usuarios se les ha asignado la directiva de acceso de usuario externo FederationAndPICDefault. Como sabemos eso, puede mostrar una lista de todos esos usuarios mediante la ejecución de un comando simple. Este es el comando:

Get-CsOnlineUser -Filter {ExternalAccessPolicy -eq "FederationAndPICDefault"} | Select-Object DisplayName

En otras palabras, veremos a todos los usuarios donde la propiedad ExternalAccessPolicy se establece en FederationAndPICDefault. (Y, para limitar la cantidad de información que aparece en pantalla, use el cmdlet Select-Object para mostrar solo el nombre para mostrar de cada usuario).

Para configurar todas nuestras cuentas de usuario para que usen esa misma directiva, use este comando:

Get-CsOnlineUser | Grant-CsExternalAccessPolicy "FederationAndPICDefault"

Este comando usa Get-CsOnlineUser para devolver una colección de todos los usuarios que se han habilitado para Lync y, a continuación, envía toda esa información a Grant-CsExternalAccessPolicy, que asigna la directiva FederationAndPICDefault a todos y cada uno de los usuarios de la colección.

Como ejemplo adicional, supongamos que ha asignado anteriormente a Alex la directiva FederationAndPICDefault y ahora ha cambiado de opinión y desea que se administre mediante la directiva de acceso externo global. No se puede asignar explícitamente la directiva global a nadie. En su lugar, la directiva global se usa para un usuario determinado si no se asigna ninguna directiva por usuario a ese usuario. Por lo tanto, si queremos que Alex se administre mediante la directiva global, debe anular la asignación de cualquier directiva por usuario que se le haya asignado anteriormente. Este es un comando de ejemplo:

Grant-CsExternalAccessPolicy -Identity "Alex Darrow" -PolicyName $Null

Este comando establece el nombre de la directiva de acceso externo asignada a Alex en un valor null ($Null). Null significa "nothing". En otras palabras, no se asigna ninguna directiva de acceso externo a Alex. Cuando no se asigna ninguna directiva de acceso externo a un usuario, la directiva global administra ese usuario.

Administración de un gran número de usuarios

Para administrar un gran número de usuarios (1000 o más), debe procesar por lotes los comandos a través de un bloque de script mediante el cmdlet Invoke-Command . En ejemplos anteriores, cada vez que se ejecuta un cmdlet, debe configurar la llamada y, a continuación, esperar el resultado antes de enviarlo de vuelta. Cuando se usa un bloque de script, esto permite que los cmdlets se ejecuten de forma remota y, una vez completados, vuelvan a enviar los datos.

$s = Get-PSSession | Where-Object { ($.ComputerName -like '*.online.lync.com' -or $.Computername -eq 'api.interfaces.records.teams.microsoft.com') -and $.State -eq 'Opened' -and $.Availability -eq 'Available' }

$users = Get-CsOnlineUser -Filter { ClientPolicy -eq $null } -ResultSize 500

$batch = 50
$filter = ''
$total = $users.Count
$count = 0
    $users | ForEach-Object {
    $upn = $_.UserPrincipalName
    $filter += "(UserPrincipalName -eq '$upn')"
    $batch--
    $count++
    if (($batch -eq 0) -or ($count -eq $total)) {
        $filterSB=[ScriptBlock]::Create($filter)
        Invoke-Command -Session $s -ScriptBlock {param($f) Get-CsOnlineUser -filter $f | Grant-CsClientPolicy -PolicyName "ClientPolicyNoIMURL" -Passthru | Grant-CsExternalAccessPolicy -PolicyName "FederationAndPICDefault"} -ArgumentList $filterSB

        # Reset
        $batch = 50
        $filter = ''
    } else {
        $filter += " -or "
    }
}

Esto busca 500 usuarios a la vez que no tienen una directiva de cliente. Les concede la directiva de cliente "ClientPolicyNoIMURL" y la directiva de acceso externo "FederationAndPicDefault". Los resultados se procesan por lotes en grupos de 50 y cada lote de 50 se envía a la máquina remota.

Vea también

Administrar Skype Empresarial Online con PowerShell

Administrar Microsoft 365 con PowerShell

Introducción a PowerShell para Microsoft 365