New-CsProxyConfiguration
Tópico modificado em: 2012-03-26
Cria uma nova coleção de definições de configuração de proxy.
Sintaxe
New-CsProxyConfiguration -Identity <XdsIdentity> [-AcceptClientCompression <$true | $false>] [-AcceptServerCompression <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisableNtlmFor2010AndLaterClients <$true | $false>] [-DnsCacheRecordCount <UInt32>] [-EnableWhiteSpaceKeepAlive <$true | $false>] [-Force <SwitchParameter>] [-InMemory <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>]]
Descrição Detalhada
O Microsoft Lync Server 2010 permite gerenciar os servidores proxy através de definições de configuração de servidor proxy. Essas definições, que podem ser aplicadas no escopo global e de serviço (embora apenas para os serviços do Servidor de Borda e de Registrador), permitem controlar itens como os protocolos de autenticação que podem ser utilizados pelos pontos de extremidade cliente e se a compactação será utilizada ou não nas conexões de servidor proxy de entrada e saída. Ao se instalar o Lync Server 2010, é criada automaticamente uma coleção global de definições de configuração de servidor proxy. Conforme observado, é possível criar também coleções adicionais no escopo de serviço. Estas novas coleções são criadas utilizando-se o cmdlet New-CsProxyConfiguration.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet New-CsProxyConfiguration 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 Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsProxyConfiguration"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
Identidade de Xds |
Identificador exclusivo das definições de configuração de servidor proxy a serem criadas. As definições de configuração de servidor proxy somente podem ser criadas no escopo de serviço e somente para os serviços Servidor de Borda e Registrador. Não é possível criar definições no escopo global; da mesma forma, não é possível criar definições no escopo de serviço, se o serviço em questão já hospedar uma coleção de definições de servidor proxy. Por exemplo, se o serviço Registrar:atl-cs-001.litwareinc.com já hospedar definições de servidor proxy, qualquer comando que tente criar novas definições para esse serviço irá falhar. Para especificar a identidade das novas definições de servidor proxy, utilize uma sintaxe similar a esta: -Identity "service:Registrar:atl-cs-001.litwareinc.com". |
AcceptClientCompression |
Opcional |
Booleano |
Quando este valor estiver definido como True (o valor padrão), o servidor proxy aceitará todas as requisições de compactação recebidas de pontos de extremidade cliente. |
AcceptServerCompression |
Opcional |
Booleano |
Quando este valor estiver definido como True (o valor padrão), o servidor proxy aceitará todas as requisições de compactação recebidas de outros servidores. |
DNSCacheRecordCount |
Opcional |
Inteiro |
Número máximo de registros que podem ser mantidos no cache do registro DNS. O valor padrão é 30000. |
DisableNTLMFor2010AndLaterClients |
Opcional |
Booleano |
Quando este valor estiver definido como True, os usuários que efetuarem o logon no Microsoft Lync 2010 deverão utilizar o protocolo Kerberos para autenticação. O valor padrão é False. |
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 de cliente para servidor que podem ser compactadas em um determinado instante; qualquer conexão além deste limite não será compactada. A contagem de compactação pode ser definida como qualquer valor inteiro entre 0 e 65535, inclusive. O valor padrão é 15000. |
MaxClientMessageBodySizeKB |
Opcional |
Inteiro |
O tamanho máximo permitido (in quilobytes) para o corpo da mensagem enviada de um ponto de extremidade cliente. Como o valor padrão é 128, serão rejeitadas as mensagens cujo tamanho do corpo for superior a 128 KB. O tamanho do corpo da mensagem cliente pode ser definido com qualquer valor inteiro entre 64 e 256, inclusive. |
MaxServerCompressionCount |
Opcional |
Inteiro |
Indica o número máximo de conexões de servidor para servidor que podem ser compactadas em um determinado instante; qualquer conexão além deste limite não será compactada. A contagem de compactação do servidor pode ser definida como qualquer valor inteiro entre 0 e 65535, inclusive. O valor padrão é 1024. |
MaxServerMessageBodySizeKB |
Opcional |
Inteiro |
O tamanho máximo permitido (in quilobytes) do corpo da mensagem enviada de um outro servidor. Como o valor padrão é 5000, serão rejeitadas as mensagens cujo tamanho do corpo for superior a 5000 KB. O tamanho do corpo da mensagem do servidor pode ser definido com qualquer valor inteiro entre 1000 e 20000, inclusive. |
OutgoingTLSCount |
Opcional |
Inteiro |
Especifica o número máximo de conexões TLS que podem ser utilizadas por cada servidor interno. O número mínimo de conexões TLS é 1 e o máximo é 4. Como padrão, OutgoingTlsCount é definido com o valor 4. |
Realm |
Opcional |
Objeto SipProxy |
Indica se as credenciais de segurança são processadas ou não pelo território do servidor proxy padrão (Serviço de Comunicação SIP) ou por um território personalizado. Os territórios personalizados devem ser especificados (e criados) utilizando-se o cmdlet New-CsSipProxyCustom. |
RequestServerCompression |
Opcional |
Booleano |
Quando este valor estiver definido como True (o valor padrão), o servidor proxy solicitará a utilização da compactação em todas as conexões externas com outros servidores. |
TreatAllClientsAsRemote |
Opcional |
Booleano |
Quando este valor estiver definido como True, o servidor proxy funcionará como se todas as conexões cliente fossem conexões externas que passam pelo Servidor de Borda executando o Serviço de Borda de Acesso. O valor padrão é False. |
UseCertificateForClientToProxyAuth |
Opcional |
Booleano |
Quando este valor estiver definido como True (o valor padrão), os pontos extremidade cliente poderão utilizar certificados para autenticação. |
UseKerberosForClientToProxyAuth |
Opcional |
Booleano |
Quando este valor estiver definido como True (o valor padrão), os pontos extremidade cliente poderão utilizar o protocolo Kerberos de autenticação. Embora o Kerberos seja um protocolo mais seguro que o NTLM, ele não pode ser utilizado se o cliente pertencer a um domínio diferente do servidor. |
UseNtlmForClientToProxyAuth |
Opcional |
Booleano |
Quando este valor estiver definido como True (o valor padrão), os pontos de extremidade cliente poderão utilizar o protocolo NTLM para autenticação. Embora o NTLM seja um protocolo menos seguro que o Kerberos, o NTLM pode ser utilizado se o cliente pertencer a um domínio diferente do servidor. Isso não é verdadeiro para a autenticação Kerberos. |
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-CsProxyConfiguration não aceita a entrada canalizada.
Tipos de Retorno
New-CsProxyConfiguration cria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings.
Exemplo
-------------------------- Exemplo 1 --------------------------
New-CsProxyConfiguration -Identity "service:EdgeServer:atl-edge-001.litwareinc.com" -RequestServerCompression $True -MaxClientMessageBodySizeKb 256
O comando anterior cria uma nova coleção de definições de configuração de proxy para o serviço EdgeServer:atl-edge-001.litwareinc.com. Estas novas definições utilizam todos os valores padrão das propriedades do servidor proxy, com exceção de duas: RequestServerCompression, definida como True; e MaxClientMessageBodySizeKb, definida como 256. Observe que este comando falhará se as definições de servidor proxy do serviço EdgeServer:atl-edge-001.litwareinc.com já tiverem sido configuradas.
-------------------------- Exemplo 2 --------------------------
$x = New-CsProxyConfiguration -Identity "service:EdgeServer:atl-edge-001.litwareinc.com" -InMemory
$x.RequestServerCompression = $True
$x.MaxClientMessageBodySizeKb = 256
Set-CsProxyConfiguration -Instance $x
Os comandos exibidos no Exemplo 2 demonstram como é possível criar uma coleção de definições de servidor proxy que existem inicialmente apenas na memória. Para fazer isso, o primeiro comando chama New-CsProxyConfiguration, juntamente com dois parâmetros: Identity (que especifica a identidade das definições) e InMemory, que indica que as novas definições devem ser criadas somente na memória. O objeto resultante é armazenado na variável $x.
Depois que essas definições virtuais tiverem sido criadas, os comandos 2 e 3 serão utilizados para modificar os valores de propriedade RequestServerCompression e MaxClientMessageBodySizeKb, respectivamente. Finalmente, o comando 4 é utilizado para transformar as definições virtuais de configuração de servidor proxy em uma coleção de definições aplicadas ao serviço EdgeServer:atl-edge-001.litwareinc.com. Este comando final é obrigatório. Se Set-CsProxyConfiguration não for chamado, nenhuma definição será aplicada ao EdgeServer:atl-edge-001.litwareinc.com e as definições virtuais desaparecerão assim que a sessão Windows PowerShell for encerrada ou a variável $x for excluída.
Consulte Também
Outros Recursos
Get-CsProxyConfiguration
Remove-CsProxyConfiguration
Set-CsProxyConfiguration