Compartilhar via

  • Artigo

Remove-CsClientVersionPolicyRule

 

Tópico modificado em: 2012-03-25

Remove uma ou mais regras de diretiva de versão do cliente configuradas para uso na organização.

Sintaxe

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

Descrição Detalhada

Regras da versão do cliente são usadas para determinar quais aplicativos cliente podem fazer logon no Microsoft 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 são verificadas em relação a uma coleção de regras de versão do cliente para saber se alguma regra se aplica a esse aplicativo específico. Por exemplo, suponha que um usuário tente fazer logon usando o Microsoft Office Communicator 2007 R2. Para que o usuário possa fazer logon, o sistema verificará se há uma regra de versão do cliente que se aplique ao Office Communicator 2007 R2. Se essa regra existir, Lync Server 2010 realiza a ação especificada por ela. Essa ação deve ser uma das seguintes:

Allow. O usuário poderá fazer logon.

AllowAndUpgrade. O usuário vai ser autorizado a fazer logon, e sua cópia do Communicator 2007 R2 será atualizada automaticamente para a versão mais atual do Lync. As atualizações são realizadas usando-se o Microsoft Update ou o Windows Server Update Services, dependendo da configuração do sistema.

AllowWithUrl. O usuário vai ser autorizado a fazer logon, e uma mensagem será exibida direcionando o usuário a uma URL na qual a versão mais recente do Lync poderá ser baixada e instalada. A URL precisa apontar para um site que você mesmo tenha criado; esse site não é criado automaticamente durante a instalação do Lync Server.

Block. O usuário não vai ser autorizado a fazer logon.

BlockAndUpgrade. O usuário não vai ser autorizado a fazer logon, mas sua cópia do Communicator 2007 R2 será atualizada automaticamente para a versão mais recente do Lync. O usuário pode, então, tentar fazer logon usando um novo aplicativo cliente. As atualizações são realizadas usando-se o Microsoft Update ou o Windows Server Update Services, dependendo da configuração do sistema.

BlockWithUrl. O usuário não vai ser autorizado a fazer logon, mas uma mensagem será exibida direcionando-o a uma URL onde a versão mais recente do Lync poderá ser baixada e instalada. A URL precisa apontar para um site que você mesmo tenha criado; esse site não é criado automaticamente durante a instalação do Lync Server.

As regras de versão do cliente são coletadas nas diretivas de versão do cliente, que podem ser configuradas no escopo global, no escopo do site, no escopo do serviço (serviço Registrador), ou no escopo por usuário. O cmdlet Remove-CsClientVersionPolicyRule permite excluir uma ou mais das regras de diretiva do cliente configuradas para uso na organização. Essas regras podem ser excluídas de qualquer uma das diretivas de versão do cliente, inclusive a diretiva global.

É 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-CsClientVersionPolicyRule 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-CsClientVersionPolicyRule"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Xds Identity

Identificador exclusivo da regra de diretiva da versão do cliente a ser removida. A Identidade de uma regra de versão do cliente consiste no escopo em que a regra foi configurada, mais um GUID (identificador global exclusivo). Isso significa que uma regra terá uma Identity semelhante a esta: site:Redmond/1987d3c2-4544-489d-bbe3-59f79f530a83.

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.Rule. Remove-CsClientVersionPolicyRule aceita instâncias em pipeline do objeto de regra de versão de cliente.

Tipos de Retorno

Nenhuma. Em vez disso, Remove-CsClientVersionPolicyRule exclui instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.Rule.

Exemplo

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

Remove-CsClientVersionPolicyRule -Identity site:Redmond/74ba9211-8610-42f9-91ba-846cdee98820

O comando mostrado no Exemplo 1 exclui a regra de diretiva da versão do cliente com a Identidade site:Redmond/74ba9211-8610-42f9-91ba-846cdee98820. Como as Identidades devem ser exclusivas, o comando só excluirá, no máximo, uma única regra.

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

Get-CsClientVersionPolicyRule -Filter "site:Redmond/*" | Remove-CsClientVersionPolicyRule

O comando anterior exclui todas as regras de diretiva da versão do cliente configuradas para o site de Redmond. Para isso, o comando chama inicialmente Get-CsClientVersionPolicyRule com o parâmetro Filter; o valor de filtro "site:Redmond/*" limita os dados retornados a regras de diretiva com Identidade começando com o valor da cadeia de caracteres "site:Redmond/". Em seguida, essa coleção filtrada é redirecionada para Remove-CsClientVersionPolicyRule, que exclui cada item da coleção.

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

Get-CsClientVersionPolicyRule | Where-Object {$_.Enabled -eq $False} | Remove-CsClientVersionPolicyRule

O Exemplo 3 exclui todas as regras de diretiva da versão do cliente desabilitadas no momento. Para isso, o comando chama inicialmente Get-CsClientVersionPolicyRule sem nenhum parâmetro para retornar uma coleção de todas as regras de diretiva atualmente em uso na organização. Em seguida, essa coleção é redirecionada para o cmdlet Where-Object, que separa todas as regras nas quais a propriedade Enabled seja igual a False. Em seguida, a coleção filtrada é redirecionada para Remove-CsClientVersionPolicyRule, que exclui cada item da coleção.