Compartilhar via


Set-CsClientVersionPolicy

 

Tópico modificado em: 2012-03-26

Modifica uma política de versão de cliente existente. As políticas de versão de cliente permitem especificar quais clientes (como Microsoft Office Communicator 2007 R2) terão permissão para fazer o logon no sistema do Microsoft Lync Server 2010.

Sintaxe

Set-CsClientVersionPolicy [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Rules <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsClientVersionPolicy [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Rules <PSListModifier>] [-WhatIf [<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 estão autorizados a 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 são então verificadas em relação a uma coleção de regras de versão do cliente, para ver se alguma regra se aplica a esse determinado aplicativo. Se essa regra existir, o servidor do 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 Microsoft 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 evitar 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 conseguem 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.

As políticas de versão de cliente podem ser modificadas a qualquer momento; a modificação de uma política de versão de cliente normalmente significa adição de novas regras, exclusão de regras existentes ou modificação de propriedades de uma regra existente (por exemplo: alteração de uma ação de regra, de Permitir para Bloquear). Essas alterações podem ser feitas usando-se o cmdlet Set-CsClientVersionPolicy. No entanto, provavelmente será mais fácil realizar essas modificações usando-se o cmdlet CsClientVersionPolicyRule.

Por outro lado, Set-CsClientVersionPolicy permite copiar facilmente um conjunto inteiro de regras de uma política de versão de cliente para outra. Para obter detalhes, consulte a seção Exemplos, neste tópico da Ajuda.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Identidade de Xds

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

As políticas por usuário também podem ser modificadas usando-se esse cmdlet. Para modificar uma política por usuário, utilize uma sintaxe similar a esta: -Identity "SalesDepartmentPolicy".

Se esse parâmetro não for incluído, Set-CsClientVersionPolicy modificará a política global.

Instance

Opcional

Objeto ClientVersionPolicy

Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais.

Description

Opcional

Cadeia de caracteres

Permite fornecer informações explicativas sobre uma política. Por exemplo, é necessário fornecer informações que descrevam os usuários aos quais a política deve ser atribuída.

Rules

Opcional

Modificador de Lista PS

Coleção de regras individuais de políticas de cliente que foram atribuídas à política.

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.ClientVersionPolicy. Remove-CsClientVersionPolicy aceita instâncias canalizadas do objeto de política de versão do cliente.

Tipos de Retorno

Set-CsClientVersionPolicy não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionPolicy.

Exemplo

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

Set-CsClientVersionPolicy -Identity site:Redmond -Rules $Null

$x = Get-CsClientVersionPolicy -Identity site:Dublin | Select-Object -ExpandProperty Rules

Set-CsClientVersionPolicy -Identity site:Redmond -Rules $x

Os comandos exibidos no Exemplo 1 copiam todas as regras de versão de cliente de uma política de versão de cliente para outra. Para fazer isso, o primeiro comando no exemplo usa Set-CsClientVersionPolicy, para remover todas as regras da política site:Redmond. Isso é feito definindo-se como nulo o valor da propriedade Rules. Depois que as regras tiverem sido excluídas, o segundo comando no exemplo usa Get-CsClientVersionPolicy, para recuperar todas as regras de política de versão de cliente configuradas para a política site:Dublin. Essas regras são armazenadas em uma variável denominada $x.

No comando final, Set-CsClientVersionPolicy é chamado novamente, mas, dessa vez, definindo-se como $x a propriedade Rules da política Redmond. Isso copia efetivamente todas as regras da política site:Dublin e as adiciona à política site:Redmond.