Compartilhar via

  • Artigo

Get-CsClientVersionPolicy

 

Tópico modificado em: 2012-03-23

Retorna informações sobre quais clientes (como Microsoft Office Communicator 2007 R2) são suportados no ambiente do Microsoft Lync Server 2010. As políticas de versão de cliente permitem especificar quais clientes (como Office Communicator 2007 R2) poderão fazer logon no sistema do Lync Server 2010.

Sintaxe

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

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

Descrição Detalhada

As políticas de versão do cliente representam uma coleção de regras de versão do cliente; por sua vez, as regras de versão do cliente são usadas para determinar quais aplicativos clientes podem fazer logon no 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. As informações de versão incluídas no cabeçalho SIP serão então verificadas em relação a uma coleção de regras de versão de cliente, para ver se alguma das regras se aplica ao aplicativo em questão. Se essa regra existir, o Lync Server 2010 tomará a ação por ela especificada. Por exemplo: a regra deve informar ao Lync Server 2010 que permita o logon, que o bloqueie ou que permita o logon, mas atualizando o aplicativo cliente imperceptivelmente para a versão mais atual (por exemplo: atualizando o Communicator 2007 R2 para Lync 2010).

As políticas de versão de cliente, que podem ser aplicadas no escopo global, de site, de serviço (apenas no serviço Registrador) ou por usuário, conferem uma flexibilidade à determinação de quais aplicativos cliente podem ser usados para acessar o sistema. Por exemplo: talvez seja necessário impedir que os usuários façam logon no Lync Server 2010 usando o Communicator 2007 R2, porque ele não suporta os mesmos recursos e capacidades que o Lync 2010. No entanto, devido a conflitos de hardware e software, também é possível que haja um grupo de usuários que não consegue efetuar a atualização para o Lync 2010. Nesse caso, é possível criar uma outra regra e uma política de versão de cliente específica que permitam a esses usuários fazer o logon no Communicator 2007 R2.

O cmdlet Get-CsClientVersionPolicy permite recuperar todas as políticas de versão de cliente que estiverem em uso na organização, bem como exibir as regras que compõem cada uma dessas políticas.

É 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-CsClientVersionPolicy 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-CsClientVersionPolicy\b"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Identidade de Xds

Identificador exclusivo da política a ser retornada. Para retornar a política global, use essa sintaxe: -Identity global. Para retornar uma política configurada no escopo de site, utilize uma sintaxe similar a esta: -Identity "site:Redmond". Para retornar uma política configurada no escopo de serviço, utilize uma sintaxe similar a esta: -Identity "Registrar:atl-cs-001.litwareinc.com". O serviço Registrador é o único serviço que pode hospedar uma política de versão do cliente.

As políticas também podem ser configuradas no escopo por usuário. Para retornar uma dessas políticas, utilize uma sintaxe similar a esta: -Identity "SalesDepartmentPolicy".

Se esse parâmetro não for incluído, serão retornadas todas as políticas de versão de cliente configuradas para uso na organização.

Filter

Opcional

Cadeia de caracteres

Permite utilizar caracteres curinga ao se especificar a política (ou políticas) a ser recuperada. Por exemplo, esta sintaxe retorna todas as políticas que tiverem sido configuradas no escopo de site: -Filter "site:*" Essa sintaxe retorna todas as políticas que tiverem sido configuradas no escopo por usuário: -Filter "tag:*".

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 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-CsClientVersionPolicy não aceita a entrada canalizada.

Tipos de Retorno

Get-CsClientVersionPolicy retorna instâncias do objeto de política Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersion.

Exemplo

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

Get-CsClientVersionPolicy

Neste exemplo, Get-CsClientVersionPolicy é chamado sem se especificar quaisquer parâmetros adicionais. Com isso, Get-CsClientVersionPolicy retorna uma coleção de todas as políticas de versão de cliente para uso na organização.

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

Get-CsClientVersionPolicy -Identity site:Redmond

No exemplo anterior, Get-CsClientVersionPolicy retorna todas as políticas de versão do cliente que possuírem a Identidade site:Redmond. Como as identidades devem ser exclusivas, este comando nunca retornará mais do que um item.

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

Get-CsClientVersionPolicy -Filter site:*

O Exemplo 3 retorna todas as políticas de versão de cliente que tiverem sido configuradas no escopo de site. Isso é feito incluindo-se o parâmetro Filter e o valor de filtro "site:*"; esse valor informa Get-CsClientVersionPolicy que retorne apenas as políticas cuja Identidade começar com um valor de cadeia de caracteres "site:".

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

Get-CsClientVersionPolicy | Select-Object -ExpandProperty Rules

O comando usado no Exemplo 4 exibe informações detalhadas sobre cada regra que tiver sido configurada para cada política de versão de cliente. Para fazer isso, Get-CsClientVersionPolicy é usado primeiramente para recuperar uma coleção de todas as políticas de versão de cliente configuradas para uso na organização. Esta coleção será então canalizada para o cmdlet Select-Object, que utilizará o filtro ExpandProperty para expandir os valores da propriedade Rules. Quando essa propriedade for expandida, serão exibidas na tela informações detalhadas sobre cada regra (inclusive os valores de propriedade, como número de compilação, versão principal e versão secundária).