Compartilhar via

  • Artigo

Remove-CsProxyConfiguration

 

Tópico modificado em: 2012-03-25

Exclui uma coleção existente de definições de configuração de server proxy.

Sintaxe

Remove-CsProxyConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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.

Quaisquer novas definições de servidor proxy criadas podem ser excluídas posteriormente, utilizando-se o cmdlet Remove-CsProxyConfiguration. Você também pode executar o Remove-CsProxyConfiguration na coleção global. Neste caso, entretanto, as definições globais não serão removidas porque o Lync Server não permite exclui-las. Em vez disso, todas as propriedades na coleção global serão redefinidas com os seus valores padrão. Por exemplo, por padrão, as definições de servidor proxy permitem aos clientes utilizarem o protocolo Kerberos para autenticação. É possível alterar as definições globais de forma a desabilitar o uso de Kerberos. Entrentanto, se se executar o Remove-CsProxyConfiguration concomitantemente à coleção global, a propriedade em questão (UseKerberosForClientToProxyAuth) será redefinida com o seu valor padrão e o Kerberos será novamente habilitado para uso como um protocolo de autenticação.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-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 "Remove-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 removidas; por exemplo: -Identity "service:Registrar:atl-cs-001.litwareinc.com".

O Remove-CsProxyConfiguration pode também ser executado concomitantemente às definições globais. Neste caso, entretanto, as definições não serão removidas. Em vez disso, todas as propriedades na coleção global serão redefinidas com os seus valores padrão.

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.

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

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

Tipos de Retorno

Nenhuma. Em vez disso, Remove-CsProxyConfiguration exclui instâncias existentes do objeto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.ProxySettings.

Exemplo

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

Remove-CsProxyConfiguration -Identity service:EdgeServer:atl-edge-011.litwareinc.com

O comando exibido no Exemplo 1 exclui as definições de configuração de proxy que possuem a Identidade service:EdgeServer:atl-edge-litwareinc.com.

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

Get-CsProxyConfiguration -Filter "service:*" | Remove-CsProxyConfiguration

No Exemplo 2, serão excluídas todas as definições de configuração de proxy aplicadas no escopo de serviço. Para realizar essa tarefa, o comando primeiramente chama o Get-CsProxyConfiguration, juntamente com o parâmetro Filter. O valor de filtro "service:*" garante que apenas as definições de proxy que tiverem uma identidade iniciada pelo valor da cadeia de caracteres "service:" serão retornadas. A coleção filtrada será então canalizada para Remove-CsProxyConfiguration, que excluirá cada item na coleção.

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

Get-CsProxyConfiguration | Where-Object {$_.TreatAllClientsAsRemote -eq $True} | Remove-CsProxyConfiguration

O comando anterior exclui quaisquer definições de configuração de proxy que tratarem todos os clientes como sendo remotos. Para fazer isso, Get-CsProxyConfiguration será primeiramente chamado sem quaisquer parâmetros para retornar uma coleção de todas as definições de configuração de servidor de proxy em uso. Esta coleção será canalizada ao cmdlet Where-Object, que selecionará apenas as definições nas quais a propriedade TreatAllClientsAsRemote for igual a True. Essa sub-rede de definições de configuração de proxy é então canalizada para Remove-CsProxyConfiguration, que remove todas as definições da coleção.