Compartilhar via

  • Artigo

Get-CsProxyConfiguration

 

Tópico modificado em: 2012-03-23

Retorna informações sobre as definições de configuração do servidor de proxy em uso na organização.

Sintaxe

Get-CsProxyConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsProxyConfiguration [-Filter <String>] [-LocalStore <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.

O cmdlet Get-CsProxyConfiguration permite retornar informações sobre qualquer definição de configuração do servidor proxy em uso pela organização.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Identidade de Xds

Identificador exclusivo das definições de configuração do servidor de proxy a serem retornadas. Para retornar as definições globais, use essa sintaxe: -Identity global. Para retornar as definições configuradas no escopo do serviço, utilize uma sintaxe semelhante a esta: -Identity "service:EdgeServer:atl-cs-001.litwareinc.com". Observe que não é possível utilizar caracteres curinga ao se especificar uma identidade. Se quiser (ou precisar) utilizar caracteres curinga, inclua o parâmetro –Filter no seu lugar.

Se esse parâmetro não for incluído, o Get-CsProxyConfiguration retornará todas as definições de configuração do servidor de proxy em uso na organização.

Filter

Opcional

Cadeia de caracteres

Permite utilizar caracteres curinga ao se especificar as definições de configuração de proxy a serem retornadas. Por exemplo, esta sintaxe retorna todas as definições configuradas no escopo de serviço: -Filter "service:*".

Não é possível utilizar os parâmetros Filter e Identity no mesmo comando.

LocalStore

Opcional

Parâmetro de opção

Recupera os dados de configuração de proxy na réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma. Get-CsProxyConfiguration não aceita a entrada canalizada.

Tipos de Retorno

Get-CsProxyConfiguration retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings.

Exemplo

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

Get-CsProxyConfiguration

O comando apresentado no Exemplo 1 retorna uma coleção de todas as definições de configuração de proxy em uso na organização. Isso é realizado chamando-se Get-CsProxyConfiguration sem nenhum parâmetro.

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

Get-CsProxyConfiguration -Identity "service:EdgeServer:atl-cs-001.litwareinc.com"

No Exemplo 2, serão retornadas as informações sobre as definições de configuração de proxy que possuírem a Identidade service:EdgeServer:atl-cs-001.litwareinc.com. Como as identidades devem ser exclusivas, este comando nunca retornará mais do que uma coleção de definições.

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

Get-CsProxyConfiguration -Filter "service:*"

O comando anterior retorna informações sobre todas as definições de proxy que tiverem sido configuradas no escopo de site. Para realizar isso, o comando chama Get-CsProxyConfiguration com o parâmetro Filter; o valor de filtro "service:*" garante que apenas as definições cuja Identidade começar com o valor de cadeia de caracteres "service:" serão retornadas.

-------------------------- Exemplo 4 --------------------------

Get-CsProxyConfiguration | Where-Object {$_.UseCertificateForClientToProxyAuth -eq $False}

O Exemplo 4 retorna informações sobre as definições de configuração de proxy que não permitem o uso de certificados de cliente como um mecanismo de autenticação. Para fazer isso, o comando primeiramente usa Get-CsProxyConfiguration, para retornar uma coleção de todas as definições de configuração de proxy em uso. Esta coleção será canalizada para o cmdlet Where-Object, que selecionará apenas as definições cuja propriedade UseCertificateForClientToProxyAuth for igual a False.

-------------------------- Exemplo 5 --------------------------

Get-CsProxyConfiguration | Where-Object {$_.MaxClientMessageBodySizeKb -lt 5000}

O comando anterior retorna todas as definições de configuração de proxy nas quais o tamanho máximo do corpo de uma mensagem de cliente for menor do que 5000 quilobytes. Para fazer isso, o comando chama primeiramente Get-CsProxyConfiguration sem quaisquer parâmetros; isto retorna uma coleção de todas as definições de configuração de proxy em uso. Essa coleção será então canalizada para Where-Object, que selecionará apenas as definições cuja propriedade MaxClientMessageBodySizeKb for menor do que 5.000 quilobytes.