Compartilhar via

  • Artigo

Get-CsClientPolicy

 

Tópico modificado em: 2012-03-23

Retorna as informações sobre as políticas de cliente configuradas para uso na sua organização. Entre outras coisas, as políticas de clientes determinam os recursos do Microsoft Lync 2010 que são disponibilizados aos usuários. Por exemplo: é possível conceder a alguns usuários o direito de transferir arquivos, negando-o a outros usuários.

Sintaxe

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

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

Descrição Detalhada

No Lync Server 2010, as políticas de clientes substituem as definições Política de grupos usadas nas versões anteriores do produto. No Microsoft Office Communicator 2007 e no Microsoft Office Communicator 2007 R2, a Política de grupos contribuía para determinar o que os usuários poderiam fazer com o Communicator e outros clientes. Por exemplo: havia definições da Política de grupos que determinavam se os usuários poderiam ou não salvar uma transcrição de suas sessões de mensagens instantâneas, se as informações do Microsoft Outlook seriam incorporadas em suas informações de presença, e se os usuários poderiam ou não incluir emoticons ou texto formatado nas mensagens instantâneas.

Embora a Política de grupos seja útil, a tecnologia possui algumas limitações quando aplicada ao Lync Server 2010. Um dos motivos é que a Política de grupos é projetada para ser aplicada em domínios ou unidades organizacionais (OUs), o que dificulta a atribuição de políticas a um grupo de usuários mais seleto (por exemplo: todos os usuários que trabalharem em um determinado departamento ou todos os usuários que possuírem um determinado cargo). Além disso, a Política de grupos somente se aplica a usuários que efetuam logon no domínio e que o fazem usando um computador. A Política de grupos não se aplica a usuários que acessam o sistema pela Internet ou por meio de um telefone celular. Isso significa que o mesmo usuário pode ter uma experiência muito diferente, dependendo do dispositivo com o qual ele tiver feito logon e do local do logon.

Para ajudar a resolver essas inconsistências, o Lync Server 2010 usa políticas de gestão de cliente em vez de Políticas de Grupo. As políticas de cliente são aplicadas sempre que um usuário acessa o sistema, independentemente de onde o login é feito e do tipo de dispositivo usado para isso. Além disso, as políticas de cliente, como outras políticas do Lync Server 2010, podem ser prontamente direcionadas para grupos de usuários selecionados. É possível até mesmo criar uma política personalizada atribuída a um único usuário.

As políticas de cliente podem ser configuradas nos escopos global, de site ou por usuário. O cmdlet Get-CsClientPolicy permite retornar informações sobre todas as políticas de clientes que tiverem sido configuradas para uso na organização.

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

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Identidade de Xds

Identificador exclusivo da política de cliente a ser retornada. Para se referir à política global, use esta sintaxe: -Identity global. Para se referir a uma política de site, use uma sintaxe semelhante a esta: -Identity site:Redmond. Para se referir a uma política por usuário, use uma sintaxe semelhante a esta: -Identity SalesDepartmentPolicy.

Se esse parâmetro for omitido, serão retornadas todas as políticas de clientes configuradas para uso na organização.

Filter

Opcional

Cadeia de caracteres

Permite utilizar caracteres curinga ao indicar a política (ou políticas) a ser retornada. Por exemplo, para retornar todas as políticas configuradas no escopo de site, utilize essa sintaxe: -Filter "site:*" Para retornar uma coleção de todas as políticas por usuário, use essa sintaxe: -Filter "tag:*".

LocalStore

Opcional

Parâmetro de opção

Recupera os dados da política de clientes 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-CsClientPolicy não aceita a entrada canalizada.

Tipos de Retorno

Get-CsClientPolicy retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Client.ClientPolicy.

Exemplo

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

Get-CsClientPolicy

No exemplo anterior, Get-CsClientPolicy é chamado sem qualquer parâmetro adicional. Isso retorna uma coleção de todas as políticas de clientes configuradas para uso na organização.

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

Get-CsClientPolicy -Identity SalesPolicy

No Exemplo 2, Get-CsClientPolicy é usado para retornar a política de clientes por usuário cuja Identidade for SalesPolicy. Como as identidades são exclusivas, esse comando nunca retornará mais de um item.

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

Get-CsClientPolicy -Filter "tag:*"

O Exemplo 3 usa o parâmetro Filter, para retornar todas as políticas de cliente que tiverem sido configuradas no escopo por usuário. O valor de filtro "tag:*" informa a Get-CsClientPolicy que retorne apenas as políticas que tiverem uma identidade iniciada pelo valor da cadeia de caracteres "tag:".

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

Get-CsClientPolicy | Where-Object {$_.DisableSavingIM -eq $True}

O comando anterior retorna uma coleção de todas as políticas de cliente cuja propriedade DisableSavingIM for True. Para realizar isso, chama-se primeiramente Get-CsClientPolicy, sem nenhum parâmetro, para que retorne uma coleção de todas as políticas de clientes configuradas para uso na organização. Esta coleção será conectada ao cmdlet Where-Object, que selecionará apenas as políticas nas quais a propriedade DisableSavingIM for igual a True.

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

Get-CsClientPolicy | Where-Object {$_.DisableSavingIM -eq $True -and $_.EnableIMAutoArchiving -eq $False}

No Exemplo 5, as únicas políticas de clientes retornadas são as que atendem a dois critérios: a propriedade DisableSavingIM deve ser True e a propriedade EnableIMAutoArchiving deve ser False. Para fazer isso, o comando chama primeiramente Get-CsClientPolicy, para retornar uma coleção de todas as políticas de clientes configuradas para uso na organização. Esta coleção será então canalizada para Where-Object, que selecionará apenas as políticas que atenderem aos seguintes critérios: DisableSavingIM deve ser igual a True e EnableIMAutoArchiving deve ser igual a False. O operador -and informa a Where-Object que apenas os objetos que atenderem a todos os critérios especificados devem ser selecionados.

-------------------------- Exemplo 6 --------------------------

Get-CsClientPolicy | Where-Object {$_.DisableSavingIM -eq $True -or $_.EnableIMAutoArchiving -eq $False}

O Exemplo 6 é uma variação do comando exibido no Exemplo 5. No entanto, dessa vez, as políticas serão selecionadas, contanto que elas atendam a pelo menos um dos seguintes critérios: a propriedade DisableSavingIM deve ser True e/ou a propriedade EnableIMAutoArchiving deve ser False. Para fazer isso, o comando chama primeiramente Get-CsClientPolicy, para retornar uma coleção de todas as políticas de clientes configuradas para uso na organização. Esta coleção será então canalizada para Where-Object, que selecionará apenas as políticas que atenderem a pelo menos um dos seguintes critérios: DisableSavingIM deve ser igual a True e/ou EnableIMAutoArchiving deve ser igual a False. O operador -or informa a Where-Object que apenas os objetos que atenderem a pelo menos uma das condições especificadas devem ser selecionados.