New-CsClientPolicyEntry
Tópico modificado em: 2012-03-23
Adiciona novas opções às políticas de cliente do Microsoft Lync Server 2010.
Sintaxe
New-CsClientPolicyEntry -Name <String> -Value <String>
Descrição Detalhada
As políticas de cliente são o principal mecanismo utilizado pelo Lync Server 2010 para gerenciar o software de cliente, como Microsoft Lync 2010. Ao criar ou configurar uma política de cliente, você se deparará com diversas opções disponíveis. Por exemplo: é possível especificar se as fotos devem ou não ser usadas no Lync 2010, se os emoticons são permitidos ou não nas mensagens instantâneas e se o Lync 2010 salva automaticamente ou não as transcrições de sessões de mensagens instantâneas. Essas opções abrangem muitas das definições relacionadas ao cliente que os administradores precisam gerenciar.
No entanto, elas não abrangem todas as definições do cliente que os administradores precisam gerenciar. Para adicionar flexibilidade e extensibilidade de gerenciamento, as políticas do cliente incluem uma propriedade denominada PolicyEntry. Essa propriedade, que admite diversos valores, permite que os administradores adicionem novas opções de gerenciamento que não são chamadas explicitamente em políticas de clientes. Por exemplo: antes do lançamento da versão beta do Lync Server, os testadores tinham a capacidade de adicionar uma opção de feedback ao Lync 2010. Essa opção foi adicionada como uma nova entrada de política e foi criada usando-se New-CsClientPolicyEntry.
Observe que não é possível criar de maneira arbitrária novas entradas de políticas e esperar que essas entradas gerenciem o Lync 2010 ou outros aplicativos clientes. Em vez disso, será necessário aguardar uma notificação da Microsoft, relativa aos nomes e valores que podem ser usados para construir novas entradas de políticas de cliente.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet New-CsClientPolicyEntry localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsClientPolicyEntry"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Name |
Obrigatório |
Cadeia de caracteres |
Nome da nova entrada de política. Por exemplo: -Name "OnlineFeedbackURL". |
Value |
Obrigatório |
Cadeia de caracteres |
Valor a ser atribuído à nova entrada de política. Por exemplo: -Value http://www.litwareinc.com/feedback. |
Tipos de Entrada
Nenhuma. New-CsClientPolicyEntry não aceita a entrada canalizada.
Tipos de Retorno
New-CsClientPolicyEntry cria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Client.PolicyEntryType.
Exemplo
-------------------------- Exemplo 1 ------------------------
$x = New-CsClientPolicyEntry -Name "OnlineFeedbackURL" -Value "http://www.litwareinc.com/feedback"
$y = Get-CsClientPolicy -Identity global
$y.PolicyEntry.Add($x)
Set-CsClientPolicy -Instance $y
Os comandos exibidos no Exemplo 1 mostram como uma nova entrada de política pode ser adicionada à política de cliente global. Esse exemplo adiciona uma nova opção de feedback ao Lync 2010. Observe que esse exemplo é para fins demonstrativos. Não se deve esperar a possibilidade de executar esses comandos e adicionar uma opção similar de feedback à sua cópia do Lync 2010.
Para adicionar a nova entrada de política, o primeiro comando no exemplo usa New-CsClientPolicyEntry para criar uma entrada com o Nome OnlineFeedbackURL e o valor http://www.litwareinc.com/feedback. O objeto de entrada de política resultante será armazenado em uma variável denominada $x.
No segundo comando, Get-CsClientPolicy é utilizado para criar uma referência de objeto ($y) à política de cliente global. Depois que a referência de objeto tiver sido criada, usa-se o método Add para adicionar a nova entrada de política à propriedade PolicyEntry. Se PolicyEntry já tiver uma ou mais entradas, o novo valor será simplesmente anexado ao fim dessa coleção.
Finalmente, o último comando no exemplo utiliza Set-CsClientPolicy, para gravar as alterações na própria política global. Se você não chamar Set-CsClientPolicy, as alterações existirão apenas na memória e desaparecerão assim que você terminar a sessão do Windows PowerShell ou excluir a variável $x.
-------------------------- Exemplo 2 ------------------------
$x = New-CsClientPolicyEntry -Name "OnlineFeedbackURL" -Value "http://www.litwareinc.com/feedback"
Set-CsClientPolicy -Identity global -PolicyEntry $x
O Exemplo 2 é uma variação dos comandos exibidos no Exemplo 1. No entanto, nesse caso, a nova entrada de política substitui todos os itens que constarem da propriedade PolicyEntry da política global. Para isso, o primeiro comando no exemplo cria uma nova entrada de política, que será armazenada em uma variável denominada $x. O segundo comando utiliza Set-CsClientPolicy, para definir o valor da propriedade PolicyEntry como $x. Depois que o comando for concluído, o único item na propriedade PolicyEntry será a nova entrada. Todos os itens contidos nessa propriedade antes que Set-CsClientPolicy fosse chamado serão substituídos pela nova entrada.
-------------------------- Exemplo 3 ------------------------
$y = Get-CsClientPolicy -Identity global
$y.PolicyEntry.RemoveAt(0)
Set-CsClientPolicy -Instance $y
O Exemplo 3 mostra como se pode remover uma entrada de política de cliente da política global. Para isso, o primeiro comando no exemplo recupera a política de cliente global e armazena essas informações em uma variável denominada $y.
Depois que a política global tiver sido recuperada, o segundo comando no exemplo usará o método RemoveAt(), para excluir a primeira entrada de política nessa política. A entrada de política que deve ser removida é indicada pelo seu número de índice: a primeira entrada de política possui o número de índice 0, a segunda entrada de política possui o número de índice 1, e assim por diante. A sintaxe RemoveAt(0) significa que a primeira entrada de política será removida.
Assim que a entrada de política tiver sido removida da instância na memória da política global, o cmdlet Set-CsClientPolicy será então chamado para gravar essas alterações na instância real da política de cliente global.
-------------------------- Exemplo 4 ------------------------
Set-CsClientPolicy -Identity global -PolicyEntry $Null
O comando exibido no Exemplo 4 remove todas as entradas de políticas de cliente configuradas na política global. Isso é realizado usando-se o parâmetro PolicyEntry e definindo-se o valor de parâmetro como null ($Null).