Partilhar via

  • Artigo

Remove-CsStaticRoutingConfiguration

 

Tópico modificado em: 2012-03-25

Remove a coleção especificada de definições de configuração de roteamento estático.

Sintaxe

Remove-CsStaticRoutingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Quando uma mensagem SIP é enviada para alguém, é possível que essa mensagem precise atravessar diversas sub-redes e redes antes que seja entregue; o caminho percorrido pela mensagem é geralmente denominado rota. No sistema de redes, há dois tipos de rotas: dinâmica e estática. Com o roteamento dinâmico, os servidores usam algoritmos para determinar o próximo local (o próximo salto) ao qual a mensagem deverá ser encaminhada. Com o roteamento estático, os caminhos das mensagens são predeterminados pelos administradores do sistema. Quando uma mensagem é recebida por um servidor, ele verifica o endereço da mensagem e a encaminha para o servidor do próximo salto que tiver sido pré-configurado por um administrador. Se forem configuradas corretamente, as rotas estáticas ajudam a garantir a entrega precisa e pontual das mensagens, com o mínimo de sobrecarga aos servidores. A desvantagem da rota estática é que as mensagens não são roteadas novamente de maneira dinâmica no caso de uma falha de rede.

Ao se instalar o Microsoft Lync Server 2010, é criada automaticamente uma coleção global de rotas estáticas. (a coleção é criada, mas não há rotas atribuídas a ela). Além disso, o software permite criar outras coleções aplicadas ao escopo de serviço (essas novas coleções podem ser atribuídas apenas ao serviço Registrador). Se você mudar de ideia mais tarde, poderá utilizar o cmdlet Remove-CsStaticRoutingConfiguration para excluir as coleções aplicadas ao escopo de serviço.

Também é possível executar Remove-CsStaticRoutingConfiguration na coleção global. Neste caso, entretanto, a coleção global não será removida porque o Lync Server 2010 não permite exclui-las. Em vez disso, todas as propriedades na coleção global serão redefinidas com os seus valores padrão. Isto significa que todas as rotas atribuídas à coleção global serão excluídas.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Identidade de Xds

Identificador exclusivo da coleção de configurações de roteamento estático a ser removida. Para remover uma coleção configurada no escopo de serviço, use uma sintaxe semelhante a esta: -Identity "service:Registrar:atl-cs-001.litwareinc.com".

Também é possível executar Remove-CsStaticRoutingConfiguration na coleção global; para fazer isso, utilize esta sintaxe: -Identity global. Tenha em mente, entretanto, que a coleção global não será removida. Em vez disso, as propriedades nessa coleção serão redefinidas para seus valores padrão. Isso significa que todos os itens na propriedade Route serão excluídos.

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.RoutingSettings. Remove-CsStaticRoutingConfiguration aceita instâncias em pipeline do objeto de definições de roteamento estático.

Tipos de Retorno

Remove-CsStaticRoutingConfiguration não retorna um valor ou objeto. Em vez disso, o cmdlet exclui instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings.

Exemplo

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

Remove-CsStaticRoutingConfiguration -Identity "service:Registrar:atl-cs-001.litwareinc.com"

O comando exibido no Exemplo 1 remove a coleção de configuração de roteamento estático cuja Identidade for service:Registrar:atl-cs-001.litwareinc.com.

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

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

No Exemplo 2, serão removidas todas as coleções de configurações de roteamento estático aplicadas no escopo de serviço. Para fazer isso, o comando começa utilizando Get-CsStaticRoutingConfiguration e o parâmetro Filter; o valor de filtro "service:*" limita os dados retornados às coleções que tiverem uma identidade iniciada pelo valor da cadeia de caracteres "service:". Em seguida, essa coleção filtrada é canalizada para Remove-CsStaticRoutingConfiguration, que exclui cada item da coleção.

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

Get-CsStaticRoutingConfiguration | Where-Object {$_.Route.Count -eq 0} | Remove-CsStaticRoutingConfiguration

O Exemplo 3 apresenta como se pode excluir todas as coleções de configurações de roteamento estático que não tiverem sido atribuídas a nenhuma rota. Para realizar essa tarefa, o comando chama primeiramente Get-CsStaticRoutingConfiguration; isto retorna informações sobre todas as coleções de roteamento estático em uso na organização. Esta coleção será então canalizada para o cmdlet Where-Object, que selecionará apenas as coleções nas quais o número de rotas (Route.Count) for igual a 0. As informações filtradas serão então canalizadas para Remove-CsStaticRoutingConfiguration, que exclui cada coleção à qual não tiver sido atribuída pelo menos uma rota.