Remove-CsPinPolicy
Última modificación del tema: 2012-03-27
Elimina la directiva especificada de número de identificación personal (PIN). La autenticación de PIN y las directivas de PIN habilitan a los usuarios a tener acceso a Microsoft Lync Server 2010 proporcionando un PIN en lugar de un nombre de usuario o contraseña.
Sintaxis
Remove-CsPinPolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Lync Server 2010 permite a los usuarios conectarse al sistema o unirse a conferencias de red telefónica conmutada (RTC) mediante un teléfono. Normalmente, para iniciar sesión en el sistema o para unirse a una conferencia, el usuario debe escribir un nombre de usuario o una contraseña; lamentablemente, esto puede resultar problemático si se usa un teléfono que no tiene teclado alfanumérico. Por este motivo, Lync Server le permite proporcionar a los usuarios con PIN que solo contengan números; cuando se solicite, los usuarios podrán iniciar sesión en el sistema o unirse a una conferencia escribiendo el PIN en lugar de un nombre de usuario y una contraseña.
Lync Server usa directivas de PIN para administrar las propiedad de autenticación de PIN; por ejemplo, puede especificar la longitud mínima de un PIN, así como determinar si va a permitir PIN que usen “patrones comunes”, como dígitos consecutivos (por ejemplo, un PIN como 123456). Además de la directiva de PIN global creada para usted al instalar Lync Server 2010, puede crear directivas de PIN personalizadas que se aplican al ámbito del sitio o al ámbito por usuario.
El cmdlet Remove-CsPinPolicy le permite quitar las directivas de PIN que se configuraron en el ámbito del sitio o en el ámbito por usuario. Al quitar una directiva del ámbito del sitio o del ámbito por usuario, esas directivas se eliminarán y ya no estarán disponibles para su uso. Además, los usuarios a quienes se les asignaron esas directivas heredarán, de manera automática, la directiva siguiente en la jerarquía de directivas (global, del sitio, de servicio, por usuario) Por ejemplo, si quita una directiva de sitio, las configuraciones de PIN de todos los usuarios que anteriormente estaban afectados por esa directiva serán administradas por la directiva global.
También puede ejecutar Remove-CsPinPolicy para la directiva global. Sin embargo, en ese caso, no se quitará la directiva: esto se debe a que no puede eliminar la directiva global. En su lugar, todas las propiedades de la directiva global se restablecerán a sus valores predeterminados. Por ejemplo, suponga que configuró la directiva global para que use una longitud de PIN mínima de 11 dígitos. Si quita la directiva global, la longitud de PIN mínima se restablecerá al valor predeterminado de 5 dígitos.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Remove-CsPinPolicy localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsPinPolicy"}
Parámetros
Parámetro | Requerido | Tipo | Descripción |
---|---|---|---|
Identity |
Requerido |
Identidad Xds |
Identificador único que se asignó a la directiva al momento de crearla. Las directivas de PIN pueden asignarse en los ámbitos global, del sitio o por usuario. Para hacer referencia a la instancia global, use esta sintaxis: -Identity global. Para hacer referencia a una directiva en el ámbito del sitio, use esta sintaxis: -Identity site:Redmond. Para consultar una directiva en el ámbito de usuario, use una sintaxis similar a la siguiente: -Identity RedmondPINPolicy. |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no sean graves y que puedan producirse al ejecutar el comando. |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Confirm |
Opcional |
Parámetro modificador |
Solicita confirmación antes de ejecutar el comando. |
Tipos de entrada
Objeto Microsoft.Rtc.Management.WritableConfig.Policy.UserPin.UserPolicy. Remove-CsPinPolicy acepta entradas canalizadas del objeto de directiva de PIN.
Tipos de valores devueltos
Remove-CsPinPolicy no devuelve ningún valor ni objeto. En su lugar, el cmdlet quita una o más instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.UserPin.UserPolicy.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Remove-CsPinPolicy -Identity RedmondUsersPinPolicy
El comando anterior quita la directiva de PIN por usuario con Identity RedmondUsersPinPolicy.
-------------------------- Ejemplo 2 --------------------------
Get-CsPinPolicy -Filter "site:*" | Remove-CsPinPolicy
En el comando que se muestra en el Ejemplo 2, se quitan todas las directivas de PIN que se han configurado en el ámbito del sitio. Para realizar esto, se usa Get-CsPinPolicy junto con el parámetro Filter, para devolver una recopilación de todas las directivas que tienen un parámetro Identity que comienza con los caracteres "site:". Luego, esta recopilación se transfiere hacia Remove-CsPinPolicy, que elimina cada directiva de la recopilación.
-------------------------- Ejemplo 3 --------------------------
Get-CsPinPolicy | Where-Object {$_.AllowCommonPatterns -eq $True} | Remove-CsPinPolicy
En el Ejemplo 3, Get-CsPinPolicy, Where-Object y Remove-CsPinPolicy se usan para eliminar todas las directivas de PIN en donde la propiedad AllowCommonPatterns está establecida en True. Para ello, primero se usa Get-CsPinPolicy para devolver una recopilación de todas las directivas de PIN configuradas para que se usen en la organización. A continuación, esta recopilación se canaliza al cmdlet Where-Object, el cual selecciona únicamente aquellas directivas donde AllowCommonPatterns es igual a True. Por último, esa recopilación filtrada se transfiere hacia Remove-CsPinPolicy, que elimina cada directiva de la recopilación.
-------------------------- Ejemplo 4 --------------------------
Get-CsPinPolicy | Remove-CsPinPolicy
El comando que se muestra en el Ejemplo 4, elimina todas las directivas de PIN configuradas en los ámbitos del sitio y por usuario. Esto se lleva a cabo mediante el uso de Get-CsPinPolicy para devolver una recopilación de todas las directivas de PIN configuradas para ser usadas en la organización y, luego, al canalizar esa recopilación entera hacia Remove-CsPinPolicy. Observe que la directiva global también debe incluirse en esta recopilación. Sin embargo, la directiva global no se eliminará. En su lugar, todas las propiedades de la directiva global se restablecerán a sus valores predeterminados.