Partilhar via

  • Artigo

Remove-CsClientPolicy

 

Tópico modificado em: 2012-03-26

Remove uma diretiva do cliente existente. Dentre outras coisas, as diretivas do cliente ajudam a determinar os recursos do Microsoft Lync 2010 disponíveis para os usuários; por exemplo, você pode dar a alguns usuários o direito de transferir arquivos, ao mesmo tempo em que nega esse direito a outros usuários.

Sintaxe

Remove-CsClientPolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

No Lync Server 2010, as diretivas do cliente substituem as configurações da Diretiva de Grupo usadas nas versões anteriores do produto. No Microsoft Office Communicator 2007 e no Microsoft Office Communicator 2007 R2, a Diretiva de Grupo ajudava a determinar o que os usuários poderiam fazer com o Communicator e outros clientes; por exemplo, havia configurações da Diretiva de Grupo que determinavam se os usuários podiam ou não salvar uma transcrição das sessões do sistema de mensagens instantâneas; se as informações do Microsoft Outlook eram incorporadas às informações de presença e se os usuários poderiam ou não incluir emoticons ou texto formatado em mensagens instantâneas.

No entanto, por mais útil que seja a Diretiva de Grupo, a tecnologia tem algumas limitações quando aplicada ao Lync Server 2010. Por um lado, a Diretiva de Grupo foi projetada para ser aplicada por domínio ou OU (unidade organizacional); isso dificulta a destinação de diretivas para um grupo de usuários mais seleto (por exemplo, todos os usuários que trabalhem em um determinado departamento, ou todos os usuários com um cargo específico). Por outro lado, a Diretiva de Grupo só é aplicada a usuários que façam logon no domínio e que façam logon usando um computador; a Diretiva de Grupo não se aplica a usuários que acessem o Lync Server 2010 pela Internet ou que acessem o sistema usando um telefone celular. Isso significa que o mesmo usuário pode ter uma experiência diferente dependendo do dispositivo usado para fazer logon, e de onde isso acontece.

Para ajudar a resolver essas inconsistências, o Lync Server 2010 usa políticas de cliente em vez de Políticas de Grupo. As políticas de cliente são aplicadas sempre que um usuário acessa o sistema, independentemente de onde o logon é feito e do tipo de dispositivo usado para isso. Além disso, as políticas de cliente, como outras políticas do Lync Server 2010, podem ser prontamente direcionadas para grupos de usuários selecionados. É possível até mesmo criar uma política personalizada atribuída a um único usuário.

As diretivas do cliente podem ser configuradas no escopo global, do site ou segundo o usuário. As diretivas configuradas no escopo do site ou por usuário podem ser excluídas posteriormente com o cmdlet Remove-CsClientPolicy. Também é possível executar Remove-CsClientPolicy com a diretiva global. Nesse caso, a diretiva global não será removida; isso porque não é possível excluir diretivas globais. No entanto, serão restaurados os valores padrão de todas as propriedades na diretiva global.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Remove-CsClientPolicy 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-CsClientPolicy"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Xds Identity

Identificador exclusivo da diretiva do cliente a ser removida. Para "remover" a diretiva global, use esta sintaxe: -Identity global. (Observe que a diretiva global não pode realmente ser removida. Em vez disso, todas as propriedades dessa diretiva serão redefinidas para seus valores padrão). Para remover uma diretiva de site, use uma sintaxe semelhante a esta: -Identity "site:Redmond". Para remover uma diretiva por usuário, use uma sintaxe semelhante a esta: -Identity "SalesDepartmentPolicy". Não é permitido usar curingas ao especificar a Identidade de uma diretiva.

Force

Opcional

Parâmetros de opção

Se este parâmetro estiver presente, a diretiva será removida automaticamente mesmo que esteja atribuída no momento a pelo menos um usuário. Se esse parâmetro não estiver presente, Remove-CsClientPolicy não removerá automaticamente uma diretiva segundo o usuário atribuída a pelo menos um usuário. Em vez disso, um prompt de confirmação será exibido perguntando se você tem certeza de que deseja remover a diretiva. Responda sim (pressionando a tecla S) para que o comando prossiga e a diretiva seja removida.

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.Client.ClientPolicy. Remove-CsClientPolicy aceita instâncias em pipeline do objeto de diretiva de cliente.

Tipos de Retorno

Remove-CsClientPolicy não retorna um valor. Em vez disso, o cmdlet exclui instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Client.ClientPolicy.

Exemplo

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

Remove-CsClientPolicy -Identity SalesPolicy

No Exemplo 1, Remove-CsClientPolicy é usado para excluir a diretiva do cliente com Identidade SalesPolicy.

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

Get-CsClientPolicy -Filter "tag:*" | Remove-CsClientPolicy

No Exemplo 2, Get-CsClientPolicy e Remove-CsClientPolicy são usados para excluir todas as diretivas do cliente configuradas no escopo por usuário. O comando usa Get-CsClientPolicy e o parâmetro Filter para retornar uma coleção de todas as diretivas de cliente configuradas no escopo por usuário; o valor de filtro "tag:*" pede a Get-CsClientPolicy para limitar os dados recuperados a diretivas de cliente com uma Identidade que comece com um valor da cadeia de caracteres "tag:". Em seguida, a coleção filtrada é encaminhada para Remove-CsClientPolicy, que remove cada diretiva na coleção.

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

Get-CsClientPolicy | Where-Object {$_.EnableAppearOffline -eq $True} | Remove-CsClientPolicy

O comando anterior exclui todas as diretivas do cliente nas quais a propriedade EnableAppearOffline esteja definida como True. Para isso, Get-CsClientPolicy é chamado inicialmente sem nenhum parâmetro adicional; ele retorna uma coleção de todas as diretivas de cliente configuradas para uso na organização. Em seguida, essa coleção é redirecionada para o cmdlet Where-Object, que seleciona apenas as diretivas nas quais a propriedade EnableAppearOffline seja igual a True. Por sua vez, essa coleção filtrada é redirecionada para Remove-CsClientPolicy, que exclui cada diretiva da coleção.