Compartilhar via

  • Artigo

New-CsClientVersionPolicy

 

Tópico modificado em: 2012-03-23

Cria uma nova diretiva de versão de cliente. As diretivas de versão do cliente permitem especificar quais versões de clientes (como o Microsoft Office Communicator 2007 R2) poderão fazer logon no sistema do Microsoft Lync Server 2010.

Sintaxe

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

Descrição Detalhada

As diretivas de versão de cliente representam uma coleção de regras de versão de cliente; essas regras são usadas para determinar quais aplicativos cliente têm permissão para fazer logon no Lync Server 2010. Quando um usuário tenta fazer logon no Lync Server 2010, seu aplicativo cliente envia um cabeçalho SIP ao servidor; este cabeçalho inclui informações detalhadas sobre o próprio aplicativo, incluindo a versão principal do software, versão secundária e número da versão. As informações de versão incluídas no cabeçalho SIP são conferidas contra uma coleção de regras de versão de cliente para verificar se alguma regra corresponde a esse aplicativo específico. Se essa regra existir, Lync Server 2010 realiza a ação especificada por ela. Por exemplo, a regra pode dizer ao Lync Server 2010 para permitir o logon, para bloquear ou para permitir o logon e em seguida atualizar silenciosamente o aplicativo cliente para a versão mais recente (por exemplo, atualizar o Communicator 2007 R2 para o Microsoft Lync 2010).

As diretivas de versão de cliente — que podem ser aplicadas em escopo global, de site, de serviço (apenas serviço Registrador) ou por usuário — oferecem uma flexibilidade para determinar quais aplicativos cliente podem ser usados para acessar o sistema. Por exemplo, como regra geral, é possível impedir que usuários façam logon no Lync Server 2010 usando o Communicator 2007 R2, o que pode ser interessante, pois o aplicativo cliente mais antigo não tem suporte aos mesmos recursos e capacidades do Lync 2010. Porém, devido a conflitos de hardware ou software, você também pode ter um grupo de usuários que não podem atualizar para o Lync 2010. Nesse caso, é possível criar uma regra separada — e uma diretiva de versão de cliente separada — que permita que esses usuários façam logon a partir do Communicator 2007 R2.

No entanto, observe que os usuários anônimos só são afetados pelas políticas globais. Isso é devido aos usuários anônimos não estarem associados a um site ou serviço e não puderem ser atribuídos a uma política por usuário.

Novas diretivas de versão de cliente são criadas com o cmdlet New-CsClientVersionPolicy. Essas novas diretivas podem ser criadas em escopo de site, de serviço (apenas serviço Registrador) ou por usuário.

É importante observar que as diretivas de versão de cliente não se aplicam a usuários federados; os usuários federados estão presos às diretivas de versão de cliente usadas em suas próprias organizações. Por exemplo, suponha que um usuário federado utilize o cliente A, que é permitido pela organização federada. Desde que a organização federada permita o uso do cliente A, o usuário poderá se comunicar com sua organização usando esse cliente. Isso também vale mesmo que sua diretiva de versão de cliente bloqueie o uso do cliente A. As diretivas de versão de cliente aplicadas em sua organização não substituem as diretivas de versão de cliente usadas em uma organização federada.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-CsClientVersionPolicy localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsClientVersionPolicy\b"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Identificador exclusivo da diretiva a ser criada. Para criar uma diretiva em escopo de site, use uma sintaxe semelhante a esta: -Identity "site:Redmond". Para criar uma diretiva em escopo de serviço, use uma sintaxe semelhante a esta: -Identity "Registrar:atl-cs-001.litwareinc.com". O serviço Registrador é o único serviço que pode hospedar uma diretiva de versão de cliente.

As diretivas também podem ser criadas em escopo por usuário. Para criar uma diretiva por usuário, use uma sintaxe semelhante a esta: -Identity "SalesDepartmentPolicy".

Description

Opcional

Cadeia de caracteres

Permite a inclusão de um texto explicativo sobre a diretiva. Por exemplo, podem ser incluídas informações sobre os usuários aos quais a diretiva deve ser atribuída.

Rules

Opcional

Modificador de lista PS

Coleção de regras de diretiva de versão de cliente. Regras podem ser adicionadas e removidas de uma diretiva com os cmdlets New-CsClientVersionPolicyRule e Remove-CsClientVersionPolicyRule. Para adicionar uma regra ao criar a nova diretiva, crie a regra e armazene o valor em uma variável (por exemplo, $x). Em seguida, use uma sintaxe semelhante a esta para criar a nova diretiva:

New-CsClientVersionPolicy –Identity "RedmondClientVersionPolicy" –Rules @{Add=$x}

Force

Opcional

Parâmetros de opção

Suprime a exibição de mensagens de erro não fatais que possam ocorrer na execução do comando.

InMemory

Opcional

Parâmetros de opção

Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet.

WhatIf

Opcional

Parâmetros de opção

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

Confirm

Opcional

Parâmetros de opção

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

Tipos de Entrada

Nenhuma. Get-CsClientVersionPolicy não aceita entrada em pipeline.

Tipos de Retorno

New-CsClientVersionPolicy cria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionPolicy.

Exemplo

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

New-CsClientVersionPolicy -Identity site:Redmond

No Exemplo 1, uma nova diretiva de versão de cliente é criada para o site Redmond. Como nenhum parâmetro foi especificado (além do parâmetro obrigatório Identity), a nova diretiva conterá todos os valores padrão de uma diretiva de versão de cliente.

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

Get-CsSite | Select-Object Identity | ForEach-Object {New-CsClientVersionPolicy -Identity ("site:" + $_.Identity)}

O comando mostrado no Exemplo 2 cria uma nova diretiva de versão de cliente para cada site na organização. Para realizar esta tarefa, o comando primeiro chama Get-CsSite sem parâmetros adicionais para retornar uma coleção de todos os sites na topologia. Esta coleção de sites é então canalizada para o cmdlet Select-Object, que extrai a propriedade Identity de cada site. Essas Identidades são canalizadas para ForEach-Object, que seleciona cada site da coleção e cria uma nova diretiva de versão de cliente para cada site.