Compartilhar via

  • Artigo

Grant-CsClientVersionPolicy

 

Tópico modificado em: 2012-03-23

Atribui uma política de versão do cliente no escopo global, do site, do serviço ou por usuário. As políticas de versão de cliente permitem especificar quais clientes (como Microsoft Office Communicator 2007 R2) poderão fazer logon no sistema do Microsoft Lync Server 2010.

Sintaxe

Grant-CsClientVersionPolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-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 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 Office 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 esse aplicativo cliente mais antigo 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 seleto 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.

O cmdlet Grant-CsClientVersionPolicy permite atribuir políticas de versão do cliente a usuários específicos. Ao se criar uma política por usuário, ela não será atribuída automaticamente a ninguém; a atribuição não será feita enquanto não se chamar Grant-CsClientVersionPolicy para atribuir explicitamente a política a um usuário ou conjunto de usuários.

É 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 Grant-CsClientVersionPolicy localmente: RTCUniversalUserAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet foi atribuído (inclusive qualquer função RBAC personalizada que tenha sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

Parâmetro User ID

Indica a identidade da conta do usuário à qual deve se atribuir a política. A identidade de usuário pode ser especificada usando-se um dos quatro formatos a seguir: 1) O endereço SIP do usuário, 2) o UPN (nome principal de usuário), 3) o nome de domínio do usuário e nome de logon, na forma domínio\logon (por exemplo: litwareinc\kenmyer) e 4) o nome de exibição do usuário no Active Directory (por exemplo: Ken Myer). As Identidades de usuário também podem ser referenciadas usando-se o nome diferenciado do usuário no Active Directory.

Além disso, pode-se utilizar o caractere curinga asterisco (*) ao utilizar o nome de exibição como identidade do usuário. Por exemplo, a identidade "* Smith" retornará todos os usuários com nome de exibição que terminarem com o valor da cadeia de caracteres " Smith".

PolicyName

Obrigatório

Cadeia de caracteres

"Nome" da política a ser atribuída. PolicyName é simplesmente a identidade de política sem o seu escopo ("tag:"). Por exemplo: uma política cuja Identidade for tag:Redmond possui um PolicyName igual a Redmond; uma política cuja Identidade for tag:RedmondClientVersionPolicy possui um PolicyName igual a RedmondClientVersionPolicy. Para retirar a atribuição de uma política por usuário atribuída anteriormente a um usuário, defina PolicyName com um valor nulo ($Null).

DomainController

Opcional

Cadeia de caracteres

Permite especificar um controlador de domínio para se conectar ao atribuir a política. Se o parâmetro não for incluído, o cmdlet usará o primeiro controlador de domínio disponível.

PassThru

Opcional

Parâmetro de opção

Se houver, faz com que o cmdlet canalize o objeto (ou objetos) do usuário através do Windows PowerShell. Por padrão, Grant-CsClientVersionPolicy não canaliza objetos.

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

Valor de cadeia de caracteres ou objeto Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Grant-CsClientVersionPolicy aceita entrada canalizada de valores de cadeia de caracteres que representam a Identidade de uma conta de usuário. O cmdlet também aceita entrada canalizada de objetos de usuário.

Tipos de Retorno

Por padrão, Grant-CsClientVersionPolicy não retorna objetos ou valores. No entanto, se você incluir o parâmetro PassThru, o cmdlet retornará instâncias do objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSUserOrAppContact.

Exemplo

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

Grant-CsClientVersionPolicy -Identity "Ken Myer" -PolicyName "RedmondClientVersionPolicy"

No Exemplo 1, a política de versão do cliente RedmondClientVersionPolicy é atribuída ao usuário Ken Myer.

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

Get-CsUser -LdapFilter "l=Redmond" | Grant-CsClientVersionPolicy -PolicyName "RedmondClientVersionPolicy"

O comando exibido no Exemplo 2 atribui a política de versão do cliente RedmondClientVersionPolicy a todos os usuários que trabalharem na cidade de Redmond. Para realizar isso, o comando primeiramente usa Get-CsUser e o parâmetro LDAPFilter, para recuperar a coleção relevante de contas de usuário; o valor de filtro "l=Redmond" (onde "l" é a letra L minúscula, o nome do atributo LDAP para "localidade") limita a recuperação de dados aos usuários que trabalharem na cidade de Redmond. Esta coleção será então canalizada para Grant-CsClientVersionPolicy, que atribuirá a política especificada a cada usuário na coleção.

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

Get-CsUser -OU "ou=Redmond,ou=North America,dc=litwareinc,dc=com" | Grant-CsClientVersionPolicy -PolicyName "RedmondClientVersionPolicy"

No Exemplo 3, todos os usuários em uma unidade organizacional (OU) especificada são associados à política de versão de cliente RedmondClientVersionPolicy. Para cumprir essa tarefa, o comando primeiramente chama Get-CsUser e o parâmetro OU. O valor do parâmetro representa o nome diferenciado da OU a cujos usuários deve ser atribuída a política de versão do cliente (ou=Redmond,ou=North America,dc=litwareinc,dc=com). Depois que as contas de usuários tiverem sido recuperadas, a coleção será canalizada para Grant-CsClientVersionPolicy, que atribuirá RedmondClientVersionPolicy a cada um dos usuários.

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

Get-CsUser -Filter {VoicePolicy -eq "RedmondVoicePolicy"} | Grant-CsClientVersionPolicy -PolicyName "RedmondClientVersionPolicy"

O comando anterior atribui a política da versão do cliente RedmondClientVersionPolicy a todos os usuários aos quais a política de voz RedmondVoicePolicy tiver sido anteriormente atribuída. Para realizar isso, o comando primeiramente chama Get-CsUser, juntamente com o parâmetro Filter; o valor do filtro {VoicePolicy -eq "RedmondVoicePolicy"} garante que serão retornadas apenas as contas de usuários cuja propriedade VoicePolicy for igual a "RedmondVoicePolicy". As contas de usuários resultantes serão então canalizadas para Grant-CsClientVersionPolicy e atribuídas à política de versão de cliente RedmondClientVersionPolicy.

-------------------------- Exemplo 5 --------------------------

Get-CsUser | Grant-CsClientVersionPolicy -PolicyName $Null

No Exemplo 5, retira-se a atribuição das políticas de versão de cliente por usuário a todos os usuários na organização. Para fazer isso, o comando primeiramente utiliza Get-CsUser, para retornar uma coleção de todos os usuários na organização que tiverem sido habilitados para o Lync Server. Essa coleção será então canalizada para Remove-CsClientVersionPolicy, que removerá qualquer política de versão de cliente por usuário atribuída a esses usuários. Isso é feito por meio da definição, como $null, do valor de parâmetro PolicyName.