Compartilhar via

  • Artigo

Set-CsClientVersionConfiguration

 

Tópico modificado em: 2012-03-27

Modifica a coleção especificada de configurações de versão de cliente. As configurações de versão de cliente determinam se o Microsoft Lync Server 2010 verifica ou não o número de versão de cada aplicativo cliente que faz logon no sistema. Se a filtragem de versão de cliente estiver habilitada, a capacidade desse aplicativo cliente acessar o sistema será baseada nas configurações definidas na diretiva de versão de cliente apropriada.

Sintaxe

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

Set-CsClientVersionConfiguration [-Confirm [<SwitchParameter>]] [-DefaultAction <Allow | AllowWithUrl | Block | BlockWithUrl>] [-DefaultURL <String>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

O Lync Server 2010 oferece aos administradores uma liberdade considerável para especificar o software de cliente (e igualmente importante, o número de versão desse software) que os usuários podem usar para fazer logon no sistema. Por exemplo, não há razão técnica que exija que os usuários façam logon no Lync Server 2010 com o Microsoft Lync 2010; do ponto de vista técnico, nada impede que os usuários façam logon usando o Microsoft Office Communicator 2007 R2.

Por outro lado, pode haver algumas razões não técnicas para que você prefira que seus usuários não façam logon usando o Office Communicator 2007 R2. Por exemplo, o Office Communicator 2007 R2 não tem suporte a todos os recursos e capacidades encontrados no Lync 2010; com isso, os usuários que fizerem logon com o Office Communicator 2007 R2 terão uma experiência diferente dos que fizerem logon com o Lync 2010. Isso pode criar dificuldades para seus usuários; também pode criar dificuldades para a equipe de suporte técnico, que precisa oferecer suporte a vários aplicativos cliente diferentes.

Se isso representar um problema para sua organização, é possível empregar a filtragem de versão de cliente para especificar quais aplicativos cliente podem ser usados para fazer logon no Lync Server 2010. Quando o Lync Server 2010 é instalado, um conjunto global de configurações de versão de cliente é instalado e habilitado. Essas configurações são usadas para determinar se a filtragem de versão de cliente deve ou não ser habilitada. Além das configurações globais, as configurações de versão de cliente também podem ser aplicadas em escopo de site; nessas instâncias, as configurações de site terão prioridade sobre as configurações globais.

O cmdlet Set-CsClientVersionConfiguration permite a modificação de uma coleção existente de configurações de versão de cliente.

Observe que a configuração de versão de cliente não é um recurso de segurança. A tecnologia depende do autorrelatório de aplicativos cliente, e não tenta verificar se um aplicativo é de fato aquele que diz ser, nem se o número de versão desse aplicativo está correto.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsClientVersionConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

XdsIdentity

Representa o identificador exclusivo das configurações de versão de cliente a serem modificadas. Para modificar as configurações globais, use uma sintaxe como esta: -Identity global. Para modificar configurações atribuídas em escopo de site, use uma sintaxe semelhante a esta: "site:Redmond".

Se o parâmetro não for incluído, Set-CsClientVersionConfiguration irá definir automaticamente as configurações globais.

Instance

Opcional

Objetos ClientVersionPolicy

Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais.

DefaultAction

Opcional

Cadeia de caracteres

Indica a ação a ser tomada caso um usuário tente fazer logon a partir de um aplicativo cliente cujo número de versão não conste da diretiva de versão de cliente apropriada. DefaultAction deve ser definido para um dos valores seguintes:

Allow. O aplicativo cliente terá permissão para fazer logon.

AllowWithUrl. O aplicativo cliente terá permissão para fazer logon. Além disso, uma caixa de mensagem será exibida ao usuário, incluindo a URL de uma página da Web na qual o usuário poderá baixar um aplicativo cliente aprovado. A URL dessa página deve ser especificada como o valor da propriedade DefaultUrl.

Block. 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 ao usuário incluirá a URL da página da Web na qual o usuário pode baixar um aplicativo cliente aprovado. A URL dessa página deve ser especificada como o valor da propriedade DefaultUrl.

Essa propriedade será ignorada se a propriedade Enabled estiver definida como False. Quando a propriedade Enabled estiver definida como False, nenhum tipo de filtragem de versão será realizado.

DefaultUrl

Opcional

Cadeia de caracteres

Especifica a URL da página da Web na qual os usuários podem baixar um aplicativo cliente aprovado. Se for especificado e se DefaultAction estiver definido como BlockWithURL, a URL aparecerá na caixa de mensagem "Acesso negado" sempre que um usuário tentar fazer logon a partir de um aplicativo cliente não suportado.

Enabled

Opcional

Booleano

Indica se a filtragem de versão de cliente está habilitada ou desabilitada. Se a propriedade Enabled for True, o servidor irá verificar o número de versão de cada aplicativo cliente que tentar fazer logon; o servidor então permitirá ou não o acesso com base na diretiva de versão de cliente apropriada. Se a propriedade Enabled for False, qualquer aplicativo cliente capaz de fazer logon terá permissão para fazê-lo.

Force

Opcional

Parâmetros de opção

Suprime a exibição de mensagens de erro não fatais que possam ocorrer na execução do comando.

WhatIf

Opcional

Parâmetros de opção

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

Booleano

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration. Set-CsClientVersionConfiguration aceita instâncias em pipeline do objeto de configuração de versão de cliente.

Tipos de Retorno

Set-CsClientVersionConfiguration não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.ClientVersion.ClientVersionConfiguration.

Exemplo

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

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

No Exemplo 1, Set-CsClientVersionConfiguration é usado para modificar a coleção de configurações com Identidade "site:Redmond". Nesse caso, o parâmetro Enabled é definido como False para desabilitar as configurações de versão de cliente.

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

Get-CsClientVersionConfiguration | Set-CsClientVersionConfiguration -DefaultURL "https://litwareinc.com/csclients"

No exemplo anterior, a propriedade DefaultUrl é modificada para todas as configurações de versão de cliente em uso no momento na organização. Para fazer isso, o comando chama primeiro o cmdlet Get-CsClientVersionConfiguration sem parâmetros adicionais para retornar todas as configurações de versão de cliente. Essas informações são canalizadas para Set-CsClientVersionConfiguration, que define o valor de DefaultUrl de todas as coleções de configurações como https://litwareinc.com/csclients.

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

Get-CsClientVersionConfiguration | Where-Object {$_.DefaultAction -eq "Block"} | Set-CsClientVersionConfiguration -DefaultAction "BlockWithUrl" -DefaultURL "https://litwareinc.com/csclients"

No Exemplo 3, são feitas modificações em todas as configurações de versão de cliente nas quais DefaultAction esteja definido como Block. Para realizar essa tarefa, o comando primeiro usa Get-CsClientVersionConfiguration para retornar todas as configurações de versão de cliente em uso no momento. Essas informações são canalizadas para o cmdlet Where-Object, que seleciona somente os itens nos quais a propriedade DefaultAction seja igual a "Block". Essa coleção filtrada é então canalizada para Set-CsClientVersionConfiguration, que faz duas coisas com cada item na coleção: 1) define DefaultAction como BlockWithUrl e 2) define DefaultUrl como https://litwareinc.com/csclients.