Compartilhar via

  • Artigo

Remove-CsClientVersionPolicy

 

Tópico modificado em: 2012-03-26

Remove a diretiva da versão do cliente especificada. As diretivas de versão do cliente permitem especificar quais clientes (como o Microsoft Office Communicator 2007 R2) poderão fazer logon no sistema do Microsoft Lync Server 2010.

Sintaxe

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

Descrição Detalhada

As diretivas de versão de cliente representam uma coleção de regras de versão de cliente; essas regras são usadas para determinar quais aplicativos cliente têm permissão para fazer logon no Lync Server 2010. Quando um usuário tenta fazer logon no Lync Server 2010, seu aplicativo cliente envia um cabeçalho SIP ao servidor; este cabeçalho inclui informações detalhadas sobre o próprio aplicativo, incluindo a versão principal do software, versão secundária e número da versão. Em seguida, as informações da versão incluídas no cabeçalho SIP são verificadas diante de uma coleção de regras de versão do cliente para saber se alguma regra se aplica a esse aplicativo específico. Se essa regra existir, Lync Server 2010 realiza a ação especificada por ela. Por exemplo, a regra pode dizer ao Lync Server 2010 para permitir o logon, para bloquear ou para permitir o logon e em seguida atualizar silenciosamente o aplicativo cliente para a versão mais recente (por exemplo, atualizar o Communicator 2007 R2 para o Microsoft Lync 2010).

As diretivas de versão de cliente — que podem ser aplicadas em escopo global, de site, de serviço (apenas serviço Registrador) ou por usuário — oferecem uma flexibilidade para determinar quais aplicativos cliente podem ser usados para acessar o sistema. Por exemplo, como regra geral, você pode impedir que usuários façam logon no Lync Server 2010 usando o Communicator 2007 R2, já que o Communicator 2007 R2 não tem suporte aos mesmos recursos e capacidades do Lync 2010. Porém, devido a conflitos de hardware ou software, você também pode ter um grupo de usuários que não podem atualizar para o Lync 2010. Nesse caso, é possível criar uma regra separada — e uma diretiva de versão de cliente separada — que permita que esses usuários façam logon a partir do Communicator 2007 R2.

É possível criar novas diretivas usando-se o cmdlet New-CsClientVersionPolicy. Essas diretivas personalizadas poderão ser removidas posteriormente executando-se o cmdlet Remove-CsClientVersionPolicy. Quando você remove uma diretiva de versão do cliente, os usuários governados anteriormente por essa diretiva herdarão automaticamente a próxima diretiva na hierarquia de gerenciamento. Por exemplo, se você excluir uma diretiva segundo o usuário, os usuários serão governados automaticamente pela diretiva de serviço apropriada. Se não houver nenhuma diretiva de serviço, os usuários serão governados pela diretiva de site apropriada. Se não houver nenhuma diretiva de site, os usuários serão governados pela diretiva global.

Observe que sempre haverá uma diretiva global, o que significa que nenhum usuário permanecerá sem gerenciamento diante das diretivas de versão do cliente. Embora seja possível executar Remove-CsClientVersionPolicy na diretiva global, a diretiva não será efetivamente excluída. Em vez disso, os valores padrão das regras de diretiva serão restaurados.

É importante observar que as diretivas de versão de cliente não se aplicam a usuários federados; os usuários federados estão presos às diretivas de versão de cliente usadas em suas próprias organizações. Por exemplo, suponha que um usuário federado utilize o cliente A, que é permitido pela organização federada. Desde que a organização federada permita o uso do cliente A, o usuário poderá se comunicar com sua organização usando esse cliente. Isso também vale mesmo que sua diretiva de versão de cliente bloqueie o uso do cliente A. As diretivas de versão de cliente aplicadas em sua organização não substituem as diretivas de versão de cliente usadas em uma organização federada.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Xds Identity

Identificador exclusivo da diretiva a ser excluída. Para remover uma diretiva configurada no escopo do site, use uma sintaxe semelhante a esta: -Identity "site:Redmond". Para remover uma diretiva configurada no escopo de serviço, use uma sintaxe semelhante a esta: -Identity "Registrar:atl-cs-001.litwareinc.com". O serviço Registrador é o único que pode hospedar uma diretiva de versão do cliente.

As diretivas também podem ser removidas no escopo segundo o usuário. Para remover diretivas por usuário, use uma sintaxe semelhante a esta: -Identity "SalesDepartmentPolicy".

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.ClientVersion.ClientVersionPolicy. Remove-CsClientVersionPolicy aceita instâncias em pipeline do objeto de diretiva de versão de cliente.

Tipos de Retorno

Remove-CsClientVersionPolicy exclui instâncias existentes do objeto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionPolicy.

Exemplo

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

Remove-CsClientVersionPolicy -Identity site:Redmond

O comando mostrado no Exemplo 1 exclui a diretiva de versão do cliente do site de Redmond.

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

Get-CsClientVersionPolicy -Filter tag:* | Remove-CsClientVersionPolicy

No Exemplo 2, todas as diretivas de versão de cliente configuradas no escopo por usuário são excluídas. Para isso, o comando chama inicialmente Get-CsClientVersionPolicy e inclui o parâmetro Filter; o valor de filtro "tag:*" limita os dados retornados a diretivas configuradas no escopo por usuário. Em seguida, essa coleção filtrada é redirecionada para Remove-CsClientVersionPolicy, que exclui cada item da coleção.