Compartilhar via

  • Artigo

Set-CsRoutingConfiguration

 

Tópico modificado em: 2012-03-26

Modifica uma lista de rotas de voz.

Sintaxe

Set-CsRoutingConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Route <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsRoutingConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Route <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

As rotas de voz contêm instruções que informam ao Microsoft Lync Server 2010 como rotear chamadas de usuários do Enterprise Voice para números de telefone na PSTN (rede telefônica pública comutada) ou em uma PBX (Central Privada de Comutação). Com este cmdlet, é possível modificar as definições de qualquer rota de voz definida dentro de uma implantação do Lync Server 2010.

O uso deste cmdlet não é recomendado. Para modificar as configurações de roteamento, modifique as rotas de voz individuais chamando o cmdlet Set-CsVoiceRoute.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-CsRoutingConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet foi atribuído (inclusive qualquer função RBAC personalizada que tenha sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsRoutingConfiguration"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

XdsIdentity

O escopo da configuração de roteamento. Este deve ser Global.

Instance

Opcional

PstnRoutingSettings

Um objeto de configuração de roteamento (Microsoft.Rtc.Management.WritablConfig.Policy.Voice.PstnRoutingSettings). É possível recuperar um objeto desse tipo chamando-se Get-CsRoutingConfiguration.

Route

Opcional

Rota

Uma lista de todas as rotas de voz (objetos Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route) definidas na implantação do Lync Server.

Para modificar objetos de rotas de voz individuais, deve-se usar o cmdlet Set-CsVoiceRoute. Está é a maneira recomendada para modificar rotas nesta lista.

Force

Opcional

SwitchParameter

Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de se realizar as alterações.

WhatIf

Opcional

SwitchParameter

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

SwitchParameter

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.WritableConfig.Management.Policy.Voice.PSTNRoutingSettings. Aceita entrada canalizada de um objeto de configuração de roteamento.

Tipos de Retorno

Set-CsRoutingConfiguration não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnRoutingSettings.

Exemplo

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

$a = Get-CsRoutingConfiguration
$b = $a.Route | Where-Object {$_.Name -match "LocalRoute"}
$b.SuppressCallerId = $False
Set-CsRoutingConfiguration -Instance $a

São necessárias diversas etapas para modificar uma rota de voz dentro de uma configuração de roteamento. Neste exemplo, iniciamos recuperando o objeto de configuração de roteamento chamando o Get-CsRoutingConfiguration. Atribuímos o objeto recuperado (haverá somente um) à variável $a.

Na linha 2 deste exemplo, recuperamos o conteúdo da propriedade Rota da variável $a, que é uma coleção de objetos de rota de voz. Nós então canalizamos esta coleção para o cmdlet Where-Object, em que pesquisamos na coleção todos os objetos de rota de voz com um Nome correspondente à cadeia de caracteres LocalRoute. Atribuímos este objeto à variável $b.

A seguir, modificamos o objeto de rota de voz LocalRoute, atribuindo o valor $False à propriedade SuppressCallerId. Ao atualizar este objeto, atualizamos o objeto na variável $a. Entretanto, este objeto continua apenas na memória. Na etapa final, precisamos salvar estas alterações, passando $a para o parâmetro Instance de Set-CsRoutingConfiguration.

Esta não é a maneira recomendada de modificar uma configuração de roteamento. Para modificar uma configuração de roteamento, altere cada rota de voz com a propriedade Set-CsVoiceRoute, como exibido aqui:

Set-CsVoiceRoute -Identity LocalRoute -SuppressCallerId $False

Esta linha realizará a mesma tarefa exibida no Exemplo 1.