Compartilhar via

  • Artigo

Get-CsClientVersionConfiguration

 

Tópico modificado em: 2012-03-23

Recupera informações sobre a coleção especificada de definições de configuração de versão do cliente em uso na organização. As definições de configuração de versão do cliente determinam se o Microsoft Lync Server 2010 verifica ou não o número da versão de cada aplicativo cliente que se registra no sistema. Se a filtragem da versão do cliente for habilitada, a habilidade desse aplicativo cliente acessar o sistema terá como base as definições configuradas na política de versão do cliente relevante.

Sintaxe

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

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

Descrição Detalhada

O Lync Server 2010 fornece aos administradores uma margem de manobra considerável na especificação do software cliente (e, igualmente importante, no número de versão do software) que os usuários podem utilizar para efetuar o registro no sistema. Por exemplo: não há razão técnica que exija dos usuários o registro no Lync Server 2010 utilizando o Microsoft Lync 2010; não há limitações técnicas que impeçam os usuários de efetuarem o logon utilizando o Microsoft Office Communicator 2007 R2.

No entanto, é possível que haja alguns motivos não-técnicos pelos quais você prefira que seus usuários não efetuem o logon usando o Office Communicator 2007 R2. Por exemplo: o Office Communicator 2007 R2 não oferece apoio a todos os recursos e capacidades encontradas no Lync 2010. Consequentemente, os usuários que efetuarem o logon com o Office Communicator 2007 R2 terão experiência diferente da de usuários que efetuarem o logon utilizando o Lync 2010. Isto pode criar dificuldades para os usuários e também para os funcionários da assistência técnica, que deverão fornecer suporte para alguns aplicativos cliente diferentes.

Se criar problemas para sua organização, é possível implementar um filtro de versão do cliente que especifique quais aplicativos cliente poderão ser utilizados para efetuar o registro no Lync Server 2010. Ao se instalar o Lync Server 2010, será instalado e habilitado um conjunto global de definições de configuração de versão cliente. Essas definições são utilizadas para determinar se a filtragem de versão do cliente está ou não habilitada. Além das definições globais, as definições de configuração da versão do cliente também podem ser aplicadas no escopo de site; nessas instâncias, as definições de site terão precedência sobre as definições globais.

O cmdlet Get-CsClientVersionConfiguration permite recuperar informações sobre as definições de configuração de versão do cliente em uso pela organização. Observe que esse cmdlet não retorna informações sobre quais aplicativos de cliente são permitidos ou não. Para recuperar essas informações, use Get-CsClientVersionPolicy.

Observe também que a configuração de versão do cliente não é um recurso de segurança. A tecnologia consiste na emissão de relatórios próprios, por parte dos aplicativos cliente, e não tenta verificar a autenticidade de um aplicativo, nem a do número da versão que ele afirma ser.

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

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Identidade de Xds

Indica o identificador exclusivo da coleção de definições de configuração de versão do cliente que se deseja retornar. Para fazer referência às definições globais, utilize esta sintaxe: -Identity global. Para fazer referência a uma coleção configurada no escopo do site, use uma sintaxe semelhante a esta: -Identity site:Redmond. Não é possível usar caracteres curinga ao se especificar uma Identidade. Se precisar utilizar caracteres curinga, inclua o parâmetro Filter no seu lugar.

Se esse parâmetro não for especificado, Get-CsClientVersionConfiguration retornará uma coleção de todas as definições de configuração de versão do cliente em uso na organização.

Filter

Opcional

Cadeia de caracteres

Permite utilizar caracteres curinga para retornar uma coleção (ou coleções) de definições de configuração de versão do cliente. Para retornar uma coleção de todas as definições configuradas no escopo de site, utilize esta sintaxe: -Filter site:*. Para retornar uma coleção de todas as definições que tiverem o valor da cadeia de caracteres "EMEA" em alguma posição de sua identidade (a única propriedade que se pode filtrar), utilize esta sintaxe: -Filter *EMEA*.

LocalStore

Opcional

Parâmetro de opção

Recupera os dados da configuração 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-CsClientVersionConfiguration não aceita a entrada canalizada.

Tipos de Retorno

Get-CsClientVersionConfiguration retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration.

Exemplo

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

Get-CsClientVersionConfiguration

Neste exemplo, chama-se Get-CsClientVersionConfiguration sem se especificar quaisquer parâmetros adicionais. Com isso, Get-CsClientVersionConfiguration retorna uma coleção de todas as definições de configuração de versão de cliente em uso na organização.

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

Get-CsClientVersionConfiguration -Identity site:Redmond

No exemplo anterior, Get-CsClientVersionConfiguration retorna todas as definições de configuração 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-CsClientVersionConfiguration -Filter "site:*"

O Exemplo 3 retorna todas as definições de configuração de versão de cliente que tiverem sido aplicadas no escopo de site. Isto é feito incluindo-se o parâmetro Filter e o valor de filtro "site:*". Esse valor de filtro instrui Get-CsClientVersionConfiguration a retornar somente as definições que possuírem uma identidade começando com o valor de cadeia de caracteres "site:".

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

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

O comando anterior retorna todas as definições de configuração de versão do cliente que estiverem desabilitadas. Para realizar essa tarefa, o comando utiliza primeiramente Get-CsClientVersionConfiguration, para retornar uma coleção de todas as definições de versão de cliente configuradas para uso na organização. Essa coleção será então canalizada para o cmdlet Where-Object, que aplicará um filtro que limita a coleção às definições cuja propriedade Enabled for igual a False.