Compartilhar via

  • Artigo

New-CsClientVersionPolicyRule

 

Tópico modificado em: 2012-03-23

Cria uma nova regra de política de versão de cliente. As regras de política de versão de cliente ajudam a determinar se os usuários podem usar um determinado aplicativo cliente para fazer o logon no Microsoft Lync Server 2010.

Sintaxe

New-CsClientVersionPolicyRule -Identity <XdsIdentity> [-Action <Allow | AllowAndUpgrade | AllowWithUrl | Block | BlockAndUpgrade | BlockWithUrl>] [-ActionUrl <String>] [-BuildNumber <Nullable>] [-CompareOp <EQL | NEQ | GTR | GEQ | LSS | LEQ>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MajorVersion <UInt16>] [-MinorVersion <Nullable>] [-Priority <Int32>] [-QfeNumber <Nullable>] [-UserAgent <String>] [-UserAgentFullName <String>] [-WhatIf [<SwitchParameter>]]

New-CsClientVersionPolicyRule -Parent <String> -RuleId <String> [-Action <Allow | AllowAndUpgrade | AllowWithUrl | Block | BlockAndUpgrade | BlockWithUrl>] [-ActionUrl <String>] [-BuildNumber <Nullable>] [-CompareOp <EQL | NEQ | GTR | GEQ | LSS | LEQ>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MajorVersion <UInt16>] [-MinorVersion <Nullable>] [-Priority <Int32>] [-QfeNumber <Nullable>] [-UserAgent <String>] [-UserAgentFullName <String>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

As regras de política de versão de ciente são usadas para determinar quais aplicativos clientes podem fazer o 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. Em seguida, as informações de versão são verificadas em relação a uma coleção de regras de versão de cliente, para ver se alguma das regras se aplica a esse determinado aplicativo. Por exemplo: suponhamos que um usuário tente fazer o logon usando o Microsoft Office Communicator 2007 R2. Antes que o usuário possa fazer logon no Lync Server 2010, o sistema verificará se há alguma regra de versão de cliente que se aplique a Office Communicator 2007 R2. Se essa regra existir, o Lync Server 2010 tomará a ação por ela especificada. Essa ação deve ser uma das seguintes:

Allow. O usuário poderá fazer o logon.

AllowAndUpgrade. O usuário poderá fazer o logon e a sua cópia do Communicator 2007 R2 será automaticamente atualizada para a versão mais recente do Lync. As atualizações são feitas usando-se o Microsoft Update ou o Windows Server Update Services, dependendo de como o sistema tiver sido configurado.

AllowWithUrl. O usuário poderá fazer o logon e uma mensagem será exibida, indicando-lhe um URL do qual poderá ser baixada e instalada a versão mais recente do Lync. O URL deve apontar para um website que você mesmo criou. Nenhum site será criado ao se instalar o Lync Server.

Block. O usuário não poderá fazer o logon.

BlockAndUpgrade. O usuário não poderá fazer o logon, mas a sua cópia do Communicator 2007 R2 será automaticamente atualizada para a versão mais recente do Lync. Em seguida, o usuário poderá tentar fazer o logon usando o novo aplicativo cliente. As atualizações são feitas usando-se o Microsoft Update ou o Windows Server Update Services, dependendo de como o sistema tiver sido configurado.

BlockWithUrl. O usuário não poderá fazer o logon, mas será exibida uma mensagem indicando-lhe um URL do qual poderá ser baixada e instalada a versão mais recente do Lync. O URL deve apontar para um website que você mesmo criou. Nenhum site será criado ao se instalar o Lync Server.

As regras de política de versão de cliente são coletadas nas políticas de versão de cliente, que podem ser configuradas no escopo global, de site, de serviço (serviço Registrador) ou por usuário. As novas regras de versão de cliente são criadas usando-se o cmdlet New-CsClientVersionPolicyRule. Ao se criar uma nova regra, também será necessário especificar a Identidade a ela correspondente. Essa Identidade consiste em um escopo (por exemplo, site:Redmond) e um identificador exclusivo (GUID). Também é possível conceber uma Identidade, ou fornecer o escopo (o parâmetro Parent) e o GUID (o parâmetro RuleId), solicitando que New-CsClientVerisonPolicyRule crie a Identidade para você.

É 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 New-CsClientVersionPolicyRule 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 do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

Identidade de Xds

Identificador exclusivo da regra de política de versão de cliente a ser criada. A Identidade de uma regra de política de versão de cliente consiste no escopo em que a regra foi configurada e de um identificador global exclusivo (GUID). Isso significa que uma regra terá uma Identidade semelhante a essa: site:Redmond/1987d3c2-4544-489d-bbe3-59f79f530a83.

Em vez de usar o parâmetro Identity, é possível usar os parâmetros Parent e RuleId, para que New-CsClientVerisonPolicyRule crie a Identidade.

MajorVersion

Obrigatório

Inteiro

Versão principal do software. Por exemplo: se a versão da cópia do Communicator for 2.0.6362.111, MajorVersion será 2. As versões principais são equivalentes aos primeiros lançamentos do software. É necessário atribuir um valor à propriedade MajorVersion, sempre que uma nova regra for criada.

MinorVersion

Opcional

Inteiro

Versão secundária do software. Por exemplo: se a versão da cópia do Communicator for 2.0.6362.111, MinorVersion será 0. As versões secundárias são equivalentes aos lançamentos intermediários do software.

UserAgent

Obrigatório

Cadeia de caracteres

Designador utilizado para identificar o cliente do software. Por exemplo: OC é a designação do agente do usuário do Communicator.

Action

Opcional

Modificador de Lista PS

Ação a ser tomada sempre que a regra for acionada (ou seja, sempre que alguém tentar fazer o logon usando o software especificado). Os valores válidos são:

Allow. O usuário poderá fazer o logon.

AllowWithUrl. O usuário poderá fazer o logon e uma mensagem será exibida indicando-lhe um URL do qual poderá ser baixada e instalada a versão mais recente do Lync.

AllowAndUpgrade. O usuário poderá fazer o logon e a sua cópia do Communicator será automaticamente atualizada para a versão mais recente do Lync.

Block. O usuário não poderá fazer o logon.

BlockWithUrl. O usuário não poderá fazer o logon, mas será exibida uma mensagem indicando-lhe um URL do qual poderá ser baixada e instalada a versão mais recente do Lync.

BlockAndUpgrade. O usuário não poderá fazer o logon, mas a sua cópia do Communicator será automaticamente atualizada para a versão mais recente do Lync. Em seguida, o usuário poderá tentar fazer o logon usando o novo aplicativo cliente.

ActionUrl

Opcional

Cadeia de caracteres

URL no qual os usuários podem fazer download da versão mais recente do Lync. Essa propriedade é obrigatória, se Ação for definida como BlockWithUrl ou AllowWithUrl.

BuildNumber

Opcional

Inteiro

Número de compilação do software. Por exemplo: se a versão da cópia do Communicator for 2.0.6362.111, BuildNumber será 6362. Os números de compilação representam versões internas do software durante o processo de desenvolvimento e ajudam a garantir que você esteja usando a versão final, e não uma versão de pré-lançamento.

CompareOp

Opcional

Modificador de Lista PS

Operador de comparação usado para determinar se o software cliente que tenta fazer o logon foi lançado antes, depois ou ao mesmo tempo que a versão especificada na regra. Os valores válidos são:

EQL (igual a)

NEQ (diferente de)

GTR (maior que)

GEQ (maior ou igual a)

LSS (menor que)

LEQ (menor ou igual a)

Description

Opcional

Cadeia de caracteres

Permite que os administradores ofereçam informações adicionais sobre a regra de versão de cliente. Por exemplo, Descrição deve incluir informações de contato da pessoa que deverá ser procurada se a regra tiver de ser alterada.

Enabled

Opcional

Booleano

Indica se a regra de versão de cliente deve ou não ser usada. Se a propriedade Enabled for definida como False ($False), a regra será ignorada sempre que um usuário tentar fazer o logon com o software especificado. O valor padrão é True.

Parent

Opcional

Cadeia de caracteres

Informações do escopo da nova regra. Para poder usar o parâmetro Parent e criar uma nova regra da política global, use essa sintaxe: -Parent global. Para criar uma nova regra de uma política de site, utilize uma sintaxe semelhante a esta: -Parent "site:Redmond". Para criar uma nova regra de uma política de serviço, utilize uma sintaxe semelhante a esta: -parent "Registrar:atl-cs-001.litwareinc.com". Para criar uma nova regra de uma política por usuário, utilize uma sintaxe semelhante a esta: -Parent "RedmondClientVersionPolicy".

É necessário utilizar o parâmetro Identity, ou os parâmetros Parent e RuleId ao se criar uma nova regra.

Priority

Opcional

Inteiro

Prioridade relativa da regra. As regras são processadas por ordem de prioridade. A regra com a prioridade 0 é processada primeiramente, a regra com a prioridade 1, em segundo lugar e assim por diante. Caso se atribua uma prioridade já em uso, a nova regra usará essa prioridade e as outras regras serão renumeradas de acordo.

QfeNumber

Opcional

Inteiro

Número de engenharia de Quick Fix do software. Por exemplo: se a versão da sua cópia do Communicator for 2.0.6362.111, QfeNumber será 111. Os números QFE representam atualizações planejadas a um aplicativo, que são disponibilizadas depois do lançamento oficial do software.

RuleId

Opcional

Guid

Identificador global exclusivo (GUID) da regra. No Windows PowerShell, é possível criar um GUID usando-se o seguinte comando:

$x = [guid]::NewGuid()

UserAgentFullName

Opcional

Cadeia de caracteres

Permite que os administradores forneçam um nome amigável para o agente do usuário. Por exemplo, em vez de confiar no UCCP do agente do usuário para identificar os administradores do agente podem fornecer o nome completo: Microsoft Unified Communications Client.

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.

InMemory

Opcional

Parâmetro 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â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

Nenhuma. New-CsClientVersionPolicyRule não aceita a entrada canalizada.

Tipos de Retorno

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

Exemplo

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

$x = [guid]::NewGuid()

New-CsClientVersionPolicyRule -Parent "site:Redmond" -RuleId $x -MajorVersion 4 -UserAgent InHouse

O Exemplo 1 mostra como criar uma nova regra de política de versão de cliente. As regras de política possuem Identidades, que são compostas de duas partes: o escopo no qual deve se atribuir o anúncio e um GUID de 36 caracteres. A criação de uma Identidade para a nova regra de política de versão de cliente primeiramente exige a utilização do método NewGuid do .NET Framework para criar um novo GUID. Essa etapa é realizada no primeiro comando do exemplo e o GUID resultante será armazenado na variável $x.

Depois que o GUID tiver sido criado, poderá se usar New-CsClientVersionPolicyRule para criar a nova regra. Esse comando usa quatro parâmetros: Parent, com um valor de parâmetro representando o escopo (site:Redmond) da nova regra; RuleId, com o valor de parâmetro $x (representando o GUID recém-criado); MajorVersion (4) e UserAgent (InHouse). Nesse caso, o parâmetro UserAgent representa um aplicativo cliente local.

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

$x = [guid]::NewGuid()

$z = New-CsClientVersionPolicyRule -Parent "site:Redmond" -RuleId $x -InMemory
$z.MajorVersion = 4 
$z.UserAgent = "Inhouse"
Set-CsClientVersionPolicyRule -Instance $z

O comando exibido no Exemplo 2 representa uma variação do comando exibido no Exemplo 1: No entanto, nesse caso, a nova regra é criada inicialmente apenas na memória e só posteriormente adicionada ao Lync Server 2010. Para realizar essa tarefa, o primeiro comando no exemplo cria a parte do GUID da Identidade. No comando 2, cria-se uma nova regra de política de versão de cliente, apenas na memória. O parâmetro InMemory garante que a regra exista apenas na memória e não seja adicionada imediatamente à infraestrutura do Lync Server 2010. Como no Exemplo 1, os parâmetros Parent e RuleId são usados para especificar o escopo e o GUID da nova regra, os dois componentes que compõem a Identidade da regra.

Depois que uma regra virtual tiver sido criada, os dois comandos seguintes serão usados para atribuir valores às propriedades MajorVersion e UserAgent, respectivamente. Quando essas tarefas tiverem sido concluídas, o comando final do exemplo e o cmdlet Set-CsClientVersionPolicyRule serão utilizados para criar a regra de política de versão de cliente e atribui-la ao site de Redmond.