Compartilhar via

  • Artigo

Remove-CsClientVersionConfiguration

 

Tópico modificado em: 2012-03-27

Remove a coleção especificada de definições de configuração da versão do cliente. 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 de acessar o sistema terá como base as definições configuradas na política relevante de versão do cliente.

Sintaxe

Remove-CsClientVersionConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<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; do ponto de vista técnico, não há nada que impeça as pessoas de efetuarem o registro no sistema 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 se registrem usando 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 registro com o Office Communicator 2007 R2 terão experiência diferente da de usuários que efetuarem o registro 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. Além das definições globais, as definições de configuração de versão do cliente também podem ser aplicadas no escopo do site.

Quaisquer definições de site que forem criadas poderão ser posteriormente excluídas utilizando-se o cmdlet Remove-CsClientVersionConfiguration. Observe que também é possível executar Remove-CsClientVersionConfiguration concomitantemente às definições globais. Neste caso, essas definições não serão removidas. Em vez disso, as propriedades globais reassumirão os seus valores padrão.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-CsClientVersionConfiguration localmente: 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 (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Identidade de Xds

Identificador exclusivo da coleção de definições de configuração da versão do cliente a ser removida. Para remover a coleção global, use a seguinte sintaxe: -Identity global (tenha em mente que as definições globais não serão removidas. Em vez disso, as propriedades globais serão redefinidas com os seus valores padrão.) Para remover uma coleção de site, utilize uma sintaxe similar a esta: -Identity site:Redmond. Observe que não é possível utilizar caracteres curinga ao se especificar a identidade.

Force

Opcional

Parâmetro de opção

Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando.

WhatIf

Opcional

Parâmetro de opção

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

Parâmetro de opção

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration. Remove-CsClientVersionConfiguration aceita instâncias canalizadas do objeto de configuração de versão do cliente.

Tipos de Retorno

Nenhuma. Em vez disso, o cmdlet exclui instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration.

Exemplo

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

Remove-CsClientVersionConfiguration -Identity site:Redmond

O comando apresentado no Exemplo 1 exclui as definições de configuração da versão do cliente que tiverem a identidade "site:Redmond".

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

Get-CsClientVersionConfiguration -Filter site:* | Remove-CsClientVersionConfiguration

No Exemplo 2, serão excluídas todas as definições de configuração da versão do cliente que tiverem sido aplicadas no escopo de site. Para realizar essa tarefa, o comando chama primeiramente Get-CsClientVersionConfiguration e o parâmetro -Filter. O valor de filtro "site:*" garante que apenas as definições de configuração da versão do cliente que tiverem a identidade iniciada pelo valor da cadeia de caracteres "site:" serão retornadas. Em seguida, essa coleção filtrada é redirecionada para Remove-CsClientVersionConfiguration, que exclui cada item da coleção.

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

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

No comando anterior, serão excluídas todas as definições de configuração de versão cliente que estiverem desabilitadas. Para fazer isso, o comando usa primeiramente Get-CsClientVersionConfiguration, retornando uma coleção de todas as definições de configuração de versão cliente em uso na organização. Depois que esses dados forem retornados, a coleção será canalizada para o cmdlet Where-Object, que selecionará somente as configurações cuja propriedade Enable for igual a False. A partir daí, a coleção filtrada será canalizada para Remove-CsClientVersionConfiguration, que excluirá cada item na coleção.