Compartilhar via


Get-CsClientVersionPolicyRule

 

Tópico modificado em: 2012-03-23

Retorna regras de política de versão de cliente configuradas para uso na organização.

Sintaxe

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

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

Descrição Detalhada

As regras de política de versão de ciente são usadas para determinar quais aplicativos clientes podem fazer o logon no Microsoft Lync Server 2010. Quando um usuário tentar fazer logon no Lync Server 2010, o seu aplicativo cliente enviará um cabeçalho SIP para o servidor; esse cabeçalho inclui informações detalhadas sobre o aplicativo em si, inclusive a versão principal do software, a versão secundária e o número da compilação. Em seguida, as informações de versão são verificadas em relação a uma coleção de regras de versão de cliente, para ver se alguma das regras se aplica a esse determinado aplicativo. Por exemplo: suponhamos que um usuário tente fazer o logon usando o Microsoft Office Communicator 2007 R2. Antes que o usuário possa fazer o logon no Lync Server 2010, o sistema verificará se há alguma regra de versão de cliente que se aplique a Office Communicator 2007 R2. Se essa regra existir, o Lync Server 2010 tomará a ação por ela especificada. Essa ação deve ser uma das seguintes:

Allow. O usuário poderá fazer o logon.

AllowAndUpgrade. O usuário poderá fazer o logon e a sua cópia do Communicator 2007 R2 será automaticamente atualizada para a versão mais recente do Lync. As atualizações são feitas usando-se o Microsoft Update ou o Windows Server Update Services, dependendo de como o sistema tiver sido configurado.

AllowWithUrl. O usuário poderá fazer o logon e uma mensagem será exibida, indicando-lhe um URL do qual poderá ser baixada e instalada a versão mais recente do Lync. O URL deve apontar para um website que você mesmo criou. Nenhum site será criado ao se instalar o Lync Server.

Block. O usuário não poderá fazer o logon.

BlockAndUpgrade. O usuário não poderá fazer o logon, mas a sua cópia do Communicator 2007 R2 será automaticamente atualizada para a versão mais recente do Lync. Em seguida, o usuário poderá tentar fazer o logon usando o novo aplicativo cliente. As atualizações são feitas usando-se o Microsoft Update ou o Windows Server Update Services, dependendo de como o sistema tiver sido configurado.

BlockWithUrl. O usuário não poderá fazer o logon, mas será exibida uma mensagem indicando-lhe um URL do qual poderá ser baixada e instalada a versão mais recente do Lync. O URL deve apontar para um website que você mesmo criou. Nenhum site será criado ao se instalar o Lync Server.

As regras de versão do cliente são coletadas nas políticas de versão do cliente. Essas políticas podem ser configuradas no escopo global, de site, de serviço (serviço Registrador) ou por usuário. O cmdlet Get-CsClientVersionPolicyRule permite aos administradores exibir informações detalhadas sobre cada uma das regras de política configuradas para uso na organização.

É importante observar que as políticas de versão do cliente não se aplicam a usuários federados. Em vez disso, os usuários federados estão comprometidos com as políticas de versão do cliente de suas próprias organizações. Por exemplo: suponha que um usuário federado use o cliente A, um cliente permitido pela organização federada. Enquanto a organização federada permitir o uso do cliente A, esse usuário poderá se comunicar com a sua organização usando esse cliente. Isso será verdadeiro, mesmo se a política de versão do cliente bloquear o uso do cliente A. As políticas de versão do cliente em vigor na organização não substituem as políticas de versão do cliente usadas em uma organização federada.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsClientVersionPolicyRule localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Identidade de Xds

Identificador exclusivo da regra de política de versão de cliente a ser recuperada. A Identidade de uma regra de versão de cliente consiste no escopo em que a regra foi configurada mais um identificador global exclusivo (GUID). Isso significa que uma regra terá uma Identidade semelhante a essa: site:Redmond/1987d3c2-4544-489d-bbe3-59f79f530a83. Como os GUIDs são de difícil memorização e manuseio, a seção Exemplos, nesse tópico da Ajuda, lista formas alternativas com as quais se pode identificar as regras a serem retornadas.

Se esse parâmetro não for especificado, serão retornadas todas as regras de políticas de versão de cliente configuradas para uso.

Filter

Opcional

Cadeia de caracteres

Permite utilizar caracteres curinga ao se especificar as regras de política de versão do cliente a serem retornadas. Por exemplo, para retornar todas as regras configuradas para o site de Redmond, utilize esta sintaxe: -Filter "site:Redmond/*".

Não é possível utilizar os parâmetros Filter e Identity no mesmo comando.

LocalStore

Opcional

Parâmetro de opção

Recupera os dados da regra de política de versão do cliente na réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma. Get-CsClientVersionPolicyRule não aceita a entrada canalizada.

Tipos de Retorno

Get-CsClientVersionPolicyRule retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.Rule.

Exemplo

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

Get-CsClientVersionPolicyRule

O Exemplo 1 retorna informações sobre todas as regras de política de versão do cliente em uso na organização.

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

Get-CsClientVersionPolicyRule -Identity "Global/2336c611-a243-4c5d-994b-eea8a524d0e4"

No Exemplo 2, são retornadas informações sobre uma única regra de política de versão de cliente: a regra que possui a Identidade Global/2336c611-a243-4c5d-994b-eea8a524d0e4.

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

Get-CsClientVersionPolicyRule -Filter "Global/*"

O comando anterior retorna todas as regras de política de versão de cliente que tiverem sido configuradas no escopo global. Para fazer isso, o comando utiliza o parâmetro Filter e o valor de filtro "Global/*". Esse valor de filtro retorna apenas as regras que possuírem uma Identidade que comece com o valor de cadeia de caracteres "Global/".

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

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

O comando exibido no Exemplo 4 retorna todas as regras de política de versão do cliente que estiverem desabilitadas. Para realizar essa tarefa, o comando primeiramente chama Get-CsClientVersionPolicy, para retornar uma coleção de todas as regras de política de cliente disponíveis. Esta coleção será canalizada para o cmdlet Where-Object, que selecionará apenas as regras cuja propriedade Enabled for igual a False.

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

Get-CsClientVersionPolicyRule | Where-Object {$_.Action -eq "Block"}

O comando anterior retorna todas as regras de política de versão do cliente que impedirem um aplicativo cliente de fazer o logon. Para fazer isso, o comando chama primeiramente Get-CsClientVersionPolicy, sem quaisquer parâmetros. Isto retorna uma coleção de todas as regras em uso. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará apenas as regras cuja propriedade Action for igual a Block.