Get-CsPinPolicy
Última modificación del tema: 2012-03-23
Devuelve información acerca de las directivas del número de identificación personal (PIN) de los clientes configuradas para el uso en la organización. La autenticación del PIN habilita a los usuarios a tener acceso a Microsoft Lync Server 2010 al proporcionar un PIN en lugar de un nombre de usuario y una contraseña.
Sintaxis
Get-CsPinPolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsPinPolicy [-Filter <String>] [-LocalStore <SwitchParameter>]
Descripción detallada
Lync Server 2010 habilita a los usuarios a conectarse al sistema o a 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 2010 lo habilita para proporcionar a los usuarios números PIN que sólo contengan números; cuando se solicite, los usuarios podrán iniciar sesión en el sistema o unirse a una conferencia al escribir el PIN en lugar de un nombre de usuario y una contraseña.
Lync Server usa directivas de PIN para administrar las propiedades de autenticación de PIN; por ejemplo, puede especificar la longitud mínima de un número PIN y determinar si va a permitir números PIN que usen "patrones comunes", como los dígitos consecutivos (por ejemplo, un número PIN como 123456). Puede usar el cmdlet Get-CsPinPolicy para recuperar información sobre las directivas de PIN configuradas en la organización en la actualidad.
Quiénes pueden ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados para ejecutar el cmdlet Get-CsPinPolicy en forma local: RTCUniversalUserAdmins, 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 "Get-CsPinPolicy"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
Identidad Xds |
Identidad única que se asigna a la directiva al 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 RedmondPolicy. Los caracteres comodín como el asterisco (*) no pueden usarse con el parámetro Identity. Para realizar una búsqueda con caracteres comodín de las directivas, use el parámetro Filter en su lugar. Si no está especificado el parámetro Identity ni Filter, Get-CsPinPolicy devolverá información sobre todas las directivas de PIN configuradas para usar en su organización. |
Filter |
Opcional |
Cadena de caracteres |
Le permite realizar una búsqueda de directivas de PIN con caracteres comodín. Por ejemplo, para encontrar todas las directivas configuradas en el ámbito de sitio, use el siguiente Filtro: site:*. Para encontrar las directivas de sitio Seattle, Seville y Saskatoon (las cuales comienzan con la letra "S") use Filter: site:S*. Tenga en cuenta que con este parámetro sólo es posible filtrar sobre la propiedad Identity. |
LocalStore |
Opcional |
Parámetro modificador |
Recupera los datos de directivas de PIN de la réplica local de Almacén de administración central, en lugar del propio Almacén de administración central. |
Tipos de entrada
Ninguno. Get-CsPinPolicy no acepta entradas canalizadas.
Tipos de valores devueltos
Get-CsPinPolicy devuelve una o más instancias del objeto Microsoft.Rtc.Management.WritableConfig.Policy.UserPin.UserPinPolicy.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Get-CsPinPolicy
El comando mostrado en el Ejemplo 1 devuelve una recopilación de todas las directivas de PIN configuradas para el uso en la organización. Si se llama a Get-CsPinPolicy sin especificar un parámetro, siempre se devuelve el conjunto completo de directivas de PIN.
-------------------------- Ejemplo 2 --------------------------
Get-CsPinPolicy -Identity "site:Redmond"
En el Ejemplo 2 se devuelve una sola directiva de PIN: aquella cuyo parámetro Identity es site:Redmond.
-------------------------- Ejemplo 3 --------------------------
Get-CsPinPolicy -Filter "tag:*"
El comando que se muestra en el Ejemplo 3 usa el parámetro Filter para devolver todas las directivas que se configuraron en el ámbito por usuario. Esto se realiza mediante el valor de filtro tag:*; este valor le indica a Get-CsPinPolicy que debe devolver sólo las directivas cuyo parámetro Identity comienza con los caracteres tag:.
-------------------------- Ejemplo 4 --------------------------
Get-CsPinPolicy | Where-Object {$_.AllowCommonPatterns -eq $True}
En el Ejemplo 4 se devuelven todas las directivas de PIN donde la propiedad AllowCommonPatterns es True. En este ejemplo, primero se llama a Get-CsPinPolicy sin ningún parámetro adicional; ello devuelve una recopilación de todas las directivas de PIN configuradas para el uso en la organización. Esa recopilación luego se pasa al cmdlet Where-Object el cual selecciona únicamente aquellas directivas en las que la propiedad AllowCommonPatterns es igual a True.
-------------------------- Ejemplo 5 --------------------------
Get-CsPinPolicy | Where-Object {$_.PinLifetime -gt 30}
Al igual que en el Ejemplo 4, el comando que se muestra en el Ejemplo 5 usa Where-Object para devolver un subconjunto de las directivas de PIN existentes. En ese caso, Where-Object recupera únicamente aquellas directivas en las que la propiedad PinLifetime es mayor que 30. Esto significa que sólo se devolverán las directivas cuyo período de expiración de PIN sea superior a 30 días.