Compartilhar via

  • Artigo

Get-CsPinPolicy

 

Tópico modificado em: 2012-03-23

Retorna informações sobre as diretivas de PIN do cliente configuradas para uso na organização. A autenticação PIN permite que os usuários acessem o Microsoft Lync Server 2010 fornecendo um PIN em vez de um nome de usuário e senha.

Sintaxe

Get-CsPinPolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsPinPolicy [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrição Detalhada

O Lync Server 2010 permite que os usuários se conectem ao sistema ou ingressem em conferências PSTN (rede telefônica pública comutada) por telefone. Geralmente, para fazer logon no sistema ou ingressar em uma conferência, o usuário precisa digitar um nome de usuário ou senha; infelizmente, digitar o nome de usuário e a senha pode ser um problema para quem usa telefones sem teclado alfanumérico. Por esse motivo, o Lync Server 2010 permite que você ofereça aos usuários PINs exclusivamente numéricos; quando solicitados, os usuários podem fazer logon no sistema ou ingressar em uma conferência digitando o PIN em vez do nome de usuário e da senha.

O Lync Server usa políticas PIN para gerenciar as propriedades de autenticação PIN. Por exemplo, é possível especificar o tamanho mínimo de um PIN e determinar se você permitirá que PINs usem "padrões comuns" como dígitos consecutivos (por exemplo, um PIN como 123456). É possível usar o cmdlet Get-CsPinPolicy para recuperar informações sobre as políticas de PIN configuradas no momento para uso na organização.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Get-CsPinPolicy localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsPinPolicy"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

XdsIdentity

Identidade exclusiva atribuída à diretiva em sua criação. As políticas PIN podem ser atribuídas no escopo global, do site ou segundo o usuário. Para se referir à instância global, use esta sintaxe: -Identity global. Para se referir a uma diretiva no escopo do site, use esta sintaxe: -Identity site:Redmond. Para se referir a uma diretiva no escopo por usuário, use uma sintaxe semelhante a esta: -Identity RedmondPolicy.

Caracteres curinga como o asterisco (*) não podem ser usados com o parâmetro Identity. Para procurar diretivas usando um curinga, use o parâmetro Filter em seu lugar.

Se nenhum dos parâmetros Identity ou Filter for especificado, Get-CsPinPolicy retornará informações sobre todas as diretivas de PIN para uso na organização.

Filter

Opcional

Cadeia de caracteres

Permite procurar diretivas PIN usando um curinga. Por exemplo, para localizar todas as diretivas configuradas no escopo do site, use este Filtro: site:*. Para localizar as diretivas de site Seattle, Seville e Saskatoon (todas começando com a letra "S"), use este Filtro: site:S*. Observe que esse parâmetro só pode filtrar baseado na propriedade Identity.

LocalStore

Opcional

Parâmetros de opção

Obtém os dados de diretiva de PIN a partir da réplica local do Repositório de Gerenciamento Central, e não do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma. Get-CsPinPolicy não aceita entrada em pipeline.

Tipos de Retorno

Get-CsPinPolicy retorna uma ou mais instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.UserPin.UserPinPolicy.

Exemplo

-------------------------- Exemplo 1 ------------------------

Get-CsPinPolicy

O comando mostrado no Exemplo 1 retorna uma coleção de todas as diretivas PIN configuradas para uso na organização. A chamada de Get-CsPinPolicy sem parâmetros sempre retorna o conjunto completo de diretivas de PIN.

-------------------------- Exemplo 2 ------------------------

Get-CsPinPolicy -Identity "site:Redmond"

O Exemplo 2 retorna uma diretiva PIN única: a diretiva com Identity site:Redmond.

-------------------------- Exemplo 3 ------------------------

Get-CsPinPolicy -Filter "tag:*"

O comando mostrado no Exemplo 3 usa o parâmetro Filter para retornar todas as diretivas configuradas no escopo por usuário. Isso é feito usando-se o valor de filtro "tag:*"; esse valor instrui Get-CsPinPolicy a retornar apenas as diretivas com propriedade Identity começando com os caracteres "tag:".

-------------------------- Exemplo 4 ------------------------

Get-CsPinPolicy | Where-Object {$_.AllowCommonPatterns -eq $True}

O Exemplo 4 retorna todas as diretivas de PIN nas quais a propriedade AllowCommonPatterns seja True. Neste exemplo, Get-CsPinPolicy é chamado primeiro sem nenhum parâmetro adicional; ele retorna uma coleção de todas as diretivas de PIN configuradas para uso na organização. Em seguida, essa coleção é passada para o cmdlet Where-Object, que separa apenas as diretivas nas quais a propriedade AllowCommonPatterns seja igual a True.

-------------------------- Exemplo 5 ------------------------

Get-CsPinPolicy | Where-Object {$_.PinLifetime -gt 30}

Assim como o Exemplo 4, o comando mostrado no Exemplo 5 usa Where-Object para retornar um subconjunto das diretivas de PIN existentes. Nesse caso, Where-Object recupera apenas as diretivas nas quais a propriedade PinLifetime seja maior do que 30. Isso significa que apenas diretivas com datas de expiração de PIN superiores a 30 dias serão retornadas.