Remove-CsPinPolicy
Tópico modificado em: 2012-03-27
Remove a diretiva de PIN especificada. A autenticação PIN e as diretivas PIN permitem que os usuários acessem o Microsoft Lync Server 2010 fornecendo um PIN em vez de um nome de usuário e senha.
Sintaxe
Remove-CsPinPolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<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 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 também determinar se você permitirá PINs que usem "padrões comuns", como dígitos consecutivos (por exemplo, um PIN como 123456). Além da política de PIN global criada para você na instalação do Lync Server 2010, é possível criar políticas de PIN personalizadas aplicadas ao escopo de site ou por usuário.
O cmdlet Remove-CsPinPolicy permite a remoção de diretivas de PIN que tenham sido configuradas em escopo de site ou por usuário. Ao remover uma diretiva em escopo de site ou por usuário, essas diretivas serão excluídas e não estarão mais disponíveis para uso. Além disso, os usuários que tiverem sido atribuídos a essas diretivas herdarão automaticamente a próxima diretiva na hierarquia de diretiva (global, site, serviço, por usuário). Por exemplo, se uma diretiva de site for removida, todos os usuários afetados anteriormente por essa diretiva terão suas configurações de PIN gerenciadas pela diretiva global.
Você também pode executar Remove-CsPinPolicy contra a diretiva global. Neste caso, entretanto, a diretiva não será removida: não é possível excluir a diretiva global. Em vez disso, todas as propriedades da diretiva global serão redefinidas para seus valores padrão. Por exemplo, vamos supor que você tenha configurado a diretiva global para utilizar um tamanho mínimo de PIN de 11 dígitos. Se remover a diretiva global, o tamanho mínimo de PIN será redefinido para o tamanho padrão de 5 dígitos.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Remove-CsPinPolicy localmente: 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 "Remove-CsPinPolicy"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
XdsIdentity |
Identificador único atribuído à diretiva quando ela foi criada. As diretivas de PIN podem ser atribuídas em escopo global, de site ou por 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 RedmondPINPolicy. |
Force |
Opcional |
Parâmetros de opção |
Suprime a exibição de mensagens de erro não fatais que possam ocorrer na execução do comando. |
WhatIf |
Opcional |
Parâmetros de opção |
Descreve o que aconteceria se o comando fosse executado sem ser executado de fato. |
Confirm |
Opcional |
Parâmetros de opção |
Solicita confirmação antes da execução do comando. |
Tipos de Entrada
Objeto Microsoft.Rtc.Management.WritableConfig.Policy.UserPin.UserPolicy. Remove-CsPinPolicy aceita entrada em pipeline do objeto de diretiva de PIN.
Tipos de Retorno
Remove-CsPinPolicy não retorna um valor ou objeto. Em vez disso, o cmdlet remove uma ou mais instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.UserPin.UserPolicy.
Exemplo
-------------------------- Exemplo 1 ------------------------
Remove-CsPinPolicy -Identity RedmondUsersPinPolicy
O comando anterior remove a diretiva de PIN por usuário com Identity RedmondUsersPinPolicy.
-------------------------- Exemplo 2 ------------------------
Get-CsPinPolicy -Filter "site:*" | Remove-CsPinPolicy
O comando mostrado no Exemplo 2 remove todas as diretivas de PIN que tenham sido configuradas em escopo de site. Para fazer isso, o cmdlet Get-CsPinPolicy é usado, com o parâmetro Filter, para retornar uma coleção de todas as diretivas que tenham Identidade começando com os caracteres "site:". A coleção é então canalizada para Remove-CsPinPolicy, que exclui todas as diretivas na coleção.
-------------------------- Exemplo 3 ------------------------
Get-CsPinPolicy | Where-Object {$_.AllowCommonPatterns -eq $True} | Remove-CsPinPolicy
No Exemplo 3, Get-CsPinPolicy, Where-Object e Remove-CsPinPolicy são usados para excluir todas as diretivas de PIN nas quais a propriedade AllowCommonPatterns seja True. Para isso, Get-CsPinPolicy é usado primeiro para retornar uma coleção de todas as diretivas de PIN configuradas para uso na organização. Esta coleção é então canalizada para o cmdlet Where-Object, que seleciona apenas as diretivas nas quais AllowCommonPatterns seja igual a True. Finalmente, a coleção filtrada é canalizada para Remove-CsPinPolicy, que exclui todas as diretivas na coleção.
-------------------------- Exemplo 4 ------------------------
Get-CsPinPolicy | Remove-CsPinPolicy
O comando mostrado no Exemplo 4 exclui todas as diretivas de PIN configuradas nos escopos por usuário e de site; para isso, o cmdlet Get-CsPinPolicy é usado para retornar uma coleção de todas as diretivas de PIN configuradas para uso na organização, e em seguida a coleção toda é encaminhada para Remove-CsPinPolicy. Observe que a diretiva global também será incluída nesta coleção. Porém, a diretiva global não será excluída. Em vez disso, todas as propriedades da diretiva global serão redefinidas para seus valores padrão.