Set-CsProxyConfiguration

 

Tópico modificado em: 2012-03-27

Modifica uma coleção existente de definições de configuração do servidor proxy.

Sintaxe

Set-CsProxyConfiguration [-Identity <XdsIdentity>] [-AcceptClientCompression <$true | $false>] [-AcceptServerCompression <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisableNtlmFor2010AndLaterClients <$true | $false>] [-DnsCacheRecordCount <UInt32>] [-EnableWhiteSpaceKeepAlive <$true | $false>] [-Force <SwitchParameter>] [-MaxClientCompressionCount <UInt32>] [-MaxClientMessageBodySizeKb <UInt32>] [-MaxServerCompressionCount <UInt32>] [-MaxServerMessageBodySizeKb <UInt32>] [-OutgoingTlsCount <UInt32>] [-Realm <IRealmChoice>] [-RequestServerCompression <$true | $false>] [-TreatAllClientsAsRemote <$true | $false>] [-UseCertificateForClientToProxyAuth <$true | $false>] [-UseKerberosForClientToProxyAuth <$true | $false>] [-UseNtlmForClientToProxyAuth <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-CsProxyConfiguration [-AcceptClientCompression <$true | $false>] [-AcceptServerCompression <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisableNtlmFor2010AndLaterClients <$true | $false>] [-DnsCacheRecordCount <UInt32>] [-EnableWhiteSpaceKeepAlive <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxClientCompressionCount <UInt32>] [-MaxClientMessageBodySizeKb <UInt32>] [-MaxServerCompressionCount <UInt32>] [-MaxServerMessageBodySizeKb <UInt32>] [-OutgoingTlsCount <UInt32>] [-Realm <IRealmChoice>] [-RequestServerCompression <$true | $false>] [-TreatAllClientsAsRemote <$true | $false>] [-UseCertificateForClientToProxyAuth <$true | $false>] [-UseKerberosForClientToProxyAuth <$true | $false>] [-UseNtlmForClientToProxyAuth <$true | $false>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

O Microsoft Lync Server 2010 permite gerenciar os servidores proxy por meio das definições de configuração do servidor proxy. Essas configurações, que podem ser aplicadas no escopo global e no escopo de serviço (embora apenas para os serviços Servidor de Borda e Registrador), permitem controlar coisas como os protocolos de autenticação que podem ser usados por pontos de extremidade do cliente e se a compactação será usada ou não nas conexões de entrada e saída do servidor proxy. Quando você instala o Lync Server 2010, uma conexão global das definições de configuração do servidor proxy é criada automaticamente. Como observado, também é possível criar coleções adicionais no escopo de serviço.

O cmdlet Set-CsProxyConfiguration fornece uma forma de modificar os valores de propriedade de uma coleção existente de definições de configuração do servidor proxy.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsProxyConfiguration 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-CsProxyConfiguration"}

Parâmetros

Parâmetro	Obrigatório	Tipo	Descrição
Identity	Obrigatório	Xds Identity	Identificador exclusivo das definições de configuração do servidor proxy a serem modificadas. Para modificar as configurações globais, use esta sintaxe: -Identity global. Para modificar definições configuradas no escopo do serviço, use uma sintaxe semelhante a esta: -Identity "service: EdgeServer:atl-edge-001.litwareinc.com". Se o parâmetro não for incluído, Set-CsProxyConfiguration modificará automaticamente as configurações globais.
Instance	Opcional	Objeto ProxySettings	Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais.
AcceptClientCompression	Opcional	Booleano	Quando definido como True (o valor padrão), o servidor proxy aceitará todas as solicitações de compactação dos pontos de extremidade do cliente.
AcceptServerCompression	Opcional	Booleano	Quando definido como True (o valor padrão), o servidor proxy aceitará todas as solicitações de compactação de outros servidores.
DisableNTLMFor2010AndLaterClients	Opcional	Booleano	Quando definido como True, os usuários que fazem logon no Microsoft Lync 2010 deverão usar o protocolo Kerberos para autenticação. O valor padrão é False.
DNSCacheRecordCount	Opcional	Inteiro	Número máximo de registros que podem ser mantidos no cache do registro DNS. O valor padrão é 30000.
EnableWhiteSpaceKeepAlive	Opcional	Booleano	Quando definido como True (o valor padrão), o servidor proxy espera que os clientes enviem periodicamente uma mensagem de "espaço em branco" (uma mensagem vazia sem nenhum conteúdo) para indicar que essa conexão continua ativa.
MaxClientCompressionCount	Opcional	Inteiro	Indica o número máximo de conexões cliente/servidor que podem ser compactadas em um dado momento; as conexões adicionais além desse limite não serão compactadas. A contagem de compactação pode ser definida como qualquer valor inteiro entre 0 e 65.535, inclusive. O valor padrão é 15.000.
MaxClientMessageBodySizeKB	Opcional	Inteiro	O tamanho permitido máximo (em quilobytes) para o corpo de uma mensagem enviada de um ponto de extremidade do cliente. O valor padrão é 128, o que significa que mensagens com um tamanho de corpo maior que 128 KB serão rejeitadas. O tamanho do corpo da mensagem do cliente pode ser definido como qualquer valor inteiro entre 64 e 256, inclusive.
MaxServerCompressionCount	Opcional	Inteiro	Indica o número máximo de conexões servidor/servidor que podem ser compactadas em um dado momento; as conexões adicionais além desse limite não serão compactadas. A contagem de compactação do servidor pode ser definida como qualquer valor inteiro entre 0 e 65.535, inclusive. O valor padrão é 1.024.
MaxServerMessageBodySizeKB	Opcional	Inteiro	O tamanho permitido máximo (em quilobytes) para o corpo de uma mensagem enviada de outro servidor. O valor padrão é 5.000, o que significa que mensagens com um tamanho de corpo maior que 5.000 KB serão rejeitadas. O tamanho do corpo da mensagem do servidor pode ser definido como qualquer valor inteiro entre 1.000 e 20.000, inclusive.
OutgoingTLSCount	Opcional	Inteiro	Especifica o número máximo de conexões de protocolo TLS que podem ser usadas para cada servidor interno. O número mínimo de conexões TLS é 1, e o número máximo é 4. Por padrão, OutgoingTlsCount é definido como 4.
Realm	Opcional	Objeto SipProxy	Indica se as credenciais de segurança são processadas pelo realm do servidor proxy padrão (SIP Communication Services) ou por um realm personalizado. Os realms personalizados devem ser especificados (e criados) usando-se o cmdlet New-CsSipProxyCustom.
RequestServerCompression	Opcional	Booleano	Quando definido como True (o valor padrão), o servidor proxy solicita que essa compactação seja usada em todas as conexões de saída com outros servidores.
TreatAllClientsAsRemote	Opcional	Booleano	Quando definido como True, o servidor proxy funciona como se todas as conexões do cliente fossem externas, passando pelo Servidor de Borda. O valor padrão é False.
UseCertificateForClientToProxyAuth	Opcional	Booleano	Quando definido como True (o valor padrão), os pontos de extremidade do cliente poderão usar certificados para autenticação.
UseKerberosForClientToProxyAuth	Opcional	Booleano	Quando definido como True (o valor padrão), os pontos de extremidade do cliente poderão usar o protocolo Kerberos para autenticação. Embora seja um protocolo mais seguro do que NTLM, Kerberos não poderá ser usado se o cliente pertencer a um domínio diferente do que o do servidor.
UseNtlmForClientToProxyAuth	Opcional	Booleano	Quando definido como True (o valor padrão), os pontos de extremidade do cliente poderão usar o protocolo NTLM para autenticação. Embora seja um protocolo menos seguro do que Kerberos, NTLM poderá ser usado se o cliente pertencer a um domínio diferente do que o do servidor. Não é esse o caso com a autenticação Kerberos.
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	Parâmetros de opção	Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings. Set-CsProxyConfiguration aceita instâncias em pipeline do objeto de configurações de proxy.

Tipos de Retorno

Set-CsProxyConfiguration não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings.

Exemplo

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

Set-CsProxyConfiguration -Identity service:EdgeServer:atl-edge-001.litwareinc.com -AcceptServerCompression $True

No Exemplo 1, as definições de configuração de proxy com Identidade service:EdgeServer:atl-edge-001.litwareinc.com são modificadas para aceitar a compactação do servidor. Isso é feito chamando-se Set-CsProxyConfiguration e o parâmetro AcceptServerCompression e definindo-se o valor de parâmetro como True.

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

Get-CsProxyConfiguration | Where-Object {$_.AcceptServerCompression -eq $True} | Set-CsProxyConfiguration -AcceptClientCompression $True

O comando anterior localiza todas as definições de configuração de proxy que aceitam compactação do servidor e, em seguida, modifica essas configurações para também aceitar a compactação do cliente. Para isso, o comando chama inicialmente Get-CsProxyConfiguration sem nenhum parâmetro para retornar uma coleção de todas as configurações de proxy em uso na organização. Em seguida, essa coleção é redirecionada para o cmdlet Where-Object, que separa apenas as configurações nas quais a propriedade AcceptServerCompression seja igual a True. Em seguida, a coleção filtrada é redirecionada para Set-CsProxyConfiguration, que seleciona cada item da coleção e define a propriedade AcceptClientCompression como True.

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

Get-CsProxyConfiguration -Filter service:* | Set-CsProxyConfiguration -UseNtlmForClientToProxyAuth $False

O Exemplo 3 mostra como é possível modificar todas as definições do proxy configuradas no escopo do serviço. Para isso, o comando chama inicialmente Get-CsProxyConfiguration e inclui o parâmetro Filter; o valor de filtro "service:*" garante que apenas as configurações que tenham uma Identity começando com o valor da cadeia de caracteres "service:" sejam retornadas. Em seguida, a coleção filtrada é redirecionada para Set-CsProxyConfiguration, que seleciona cada item da coleção e define a propriedade UseNtlmForClientToProxyAuth como False.

Consulte Também

Outros Recursos

Get-CsProxyConfiguration
New-CsProxyConfiguration
Remove-CsProxyConfiguration