Compartilhar via


New-CsClientVersionConfiguration

 

Tópico modificado em: 2012-05-21

Cria uma nova coleção de definições de configuração de versão do cliente. As definições de configuração de versão do cliente determinam se o Microsoft Lync Server 2010 verifica ou não o número da versão de cada aplicativo cliente que se registra no sistema. Se a filtragem da versão do cliente for habilitada, a habilidade desse aplicativo cliente de acessar o sistema terá como base as definições configuradas na política relevante de versão do cliente.

Sintaxe

New-CsClientVersionConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-DefaultAction <Allow | AllowWithUrl | Block | BlockWithUrl>] [-DefaultURL <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

O Lync Server 2010 fornece aos administradores uma margem de manobra considerável na especificação do software cliente (e, igualmente importante, no número de versão do software) que os usuários podem utilizar para efetuar o registro no sistema. Por exemplo: não há razão técnica que exija dos usuários o registro no Lync Server 2010 utilizando o Microsoft Lync 2010; não há limitações técnicas que impeçam os usuários de efetuarem o logon utilizando o Microsoft Office Communicator 2007 R2.

No entanto, é possível que haja alguns motivos não-técnicos pelos quais você prefira que seus usuários não efetuem o logon usando o Office Communicator 2007 R2. Por exemplo: o Office Communicator 2007 R2 não oferece apoio a todos os recursos e capacidades encontradas no Lync 2010. Consequentemente, os usuários que efetuarem o logon com o Office Communicator 2007 R2 terão experiência diferente da de usuários que efetuarem o logon utilizando o Lync 2010. Isto pode criar dificuldades para os usuários e também para os funcionários da assistência técnica, que deverão fornecer suporte para alguns aplicativos cliente diferentes.

Se criar problemas para sua organização, é possível implementar um filtro de versão do cliente que especifique os aplicativos cliente que poderão ser utilizados para efetuar o registro no Lync Server 2010. Ao se instalar o Lync Server 2010, será instalado e habilitado um conjunto global de definições de configuração de versão cliente. Essas definições são utilizadas para determinar se a filtragem de versão do cliente está ou não habilitada.

Além das definições globais, o cmdlet New-CsClientVersionConfiguration permite criar as definições de configuração de versão do cliente no escopo de site. Quando as definições de configuração de versão do cliente forem aplicadas no escopo de site, elas terão precedência sobre as definições globais. Por exemplo: suponhamos que você tenha habilitado a filtragem de versão do cliente no escopo global e, em seguida, tenha criado uma coleção separada de definições para o site de Redmond, na qual a filtragem de versão do cliente esteja desabilitada. Nesse caso, a filtragem de versão do cliente será desabilitada para todos os usuários que possuírem contas no site de Redmond.

No entanto, observe que os usuários anônimos são afetados apenas pelas configurações globais. O motivo é que eles não são associados a um site.

Observe que a configuração de versão do cliente não é um recurso de segurança. A tecnologia consiste na emissão de relatórios próprios, por parte dos aplicativos cliente, e não tenta verificar a autenticidade de um aplicativo, nem a do número da versão que ele afirma ser.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet New-CsClientVersionConfiguration 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-CsClientVersionConfiguration"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

Identidade de Xds

Representa o identificador exclusivo a ser atribuído à nova coleção de definições de configuração de versão do cliente. Como só é possível criar novas coleções no escopo do site, a Identity sempre terá o prefixo "site:" seguido do nome do site; por exemplo "site:Redmond". Observe que o comando anterior falhará se já existir uma coleção das definições com a Identidade site:Redmond.

DefaultAction

Opcional

Cadeia de caracteres

Indica a ação a ser tomada se um usuário tentar fazer o logon em um aplicativo cliente cujo número de versão não puder ser localizado na política de versão do cliente relevante. DefaultAction deve ser definido com um dos seguintes valores:

Permitir. O aplicativo cliente poderá fazer logon.

AllowWithUrl. O aplicativo cliente poderá fazer logon. Além disso, será exibida uma caixa de mensagem para o usuário que inclui o URL de uma página da Web na qual o usuário poderá baixar um aplicativo cliente aprovado. O URL dessa página deve ser especificado como o valor da propriedade DefaultUrl.

Bloquear. O aplicativo cliente não poderá fazer logon.

BlockWithUrl. O aplicativo cliente não poderá fazer logon. No entanto, a caixa de mensagem "Acesso Negado" exibida para o usuário incluirá o URL de uma página da Web na qual o usuário poderá baixar um aplicativo cliente aprovado. O URL dessa página deve ser especificado como o valor da propriedade DefaultUrl.

Essa propriedade será ignorada se a propriedade Enabled for definida como False. Quando a propriedade Enabled for definida como False, não ocorrerá qualquer tipo de filtragem de versão do cliente.

DefaultUrl

Opcional

Cadeia de caracteres

Especifica o URL da página da web na qual os usuários poderão fazer download de um aplicativo cliente aprovado. Se for especificado e se DefaultAction for definido como BlockWithUrl, esse URL aparecerá na caixa de mensagem "Acesso negado" exibida sempre que um usuário tentar fazer o logon em um aplicativo cliente não suportado.

Enabled

Opcional

Booleano

Indica se a filtragem de versão do cliente está habilitada ou não. Se a propriedade Enabled for True, o servidor verificará o número de versão de cada aplicativo cliente que tentar fazer o logon. Em seguida, o servidor permitirá ou negará o acesso, com base na política de versão do cliente relevante. Se a propriedade Enabled for False, qualquer aplicativo cliente capaz de fazer o logon poderá fazê-lo.

O valor padrão é True.

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-CsClientVersionConfiguration não aceita a entrada canalizada.

Tipos de Retorno

Cria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration.

Exemplo

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

New-CsClientVersionConfiguration -Identity site:Redmond -Enabled $False 

O comando exibido no Exemplo 1 cria uma nova coleção de definições de configuração de versão do cliente para o site de Redmond. Nesse comando, o parâmetro Enabled é definido como False, indicando que a filtragem do cliente está desabilitada no site de Redmond.

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

$x = New-CsClientVersionConfiguration -Identity site:Redmond -InMemory
$x.DefaultAction = "Block" 
Set-CsClientVersionConfiguration -Instance $x

O Exemplo 2 mostra como se pode criar uma nova coleção de definições de configuração de versão do cliente na memória, modificar essa coleção e transformar essas definições virtuais em uma coleção real de definições aplicadas ao site de Redmond. Para realizar isso, o primeiro comando utiliza New-CsClientVersionConfiguration e o parâmetro InMemory, para criar uma nova coleção na memória de definições com a Identidade site:Redmond. Essa coleção será armazenada em uma variável denominada $x e existirá apenas na memória: se você encerrar a sessão do Windows PowerShell ou excluir a variável $x, essas definições de configuração de versão do cliente desaparecerão e nunca serão aplicadas ao site de Redmond.

No comando 2, o valor da propriedade DefaultAction das definições virtuais é definido como Block. No comando 3, o cmdlet Set-CsClientVersionConfiguration é utilizado para transformar as definições virtuais em uma coleção real de definições de configuração de versão do cliente aplicada ao site de Redmond.