Compartilhar via

  • Artigo

New-CsRoutingConfiguration

 

Tópico modificado em: 2012-03-26

Este cmdlet pode retornar um objeto contendo as definições padrão para um objeto de configuração de roteamento.

Sintaxe

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

Descrição Detalhada

Uma configuração de roteamento é um contêiner para todas as rotas de voz definidas dentro de uma implantação do Microsoft Lync Server 2010. Para criar uma nova rota de voz, use o cmdlet New-CsVoiceRoute.

Uma configuração de roteamento pode ser definida apenas em um nível global. Além disso, você não pode ter configurações de rota nomeadas individualmente, há apenas uma lista de rota de voz para a implantação inteira do Lync Server 2010. Na implementação do Lync Server 2010 do Windows PowerShell, caso se tente criar um objeto que já exista chamando-se um cmdlet que se inicie com um verbo Novo, será exibida uma mensagem de erro. Cada implementação do Lync Server 2010 inclui um objeto de configuração de roteamento padrão com uma Identidade Global. O que isso significa é que a única lista de rota que pode ser criada já existe. Portanto, uma chamada para New-CsRoutingConfiguration retornará sempre uma mensagem de erro e não criará uma nova configuração de roteamento.

A única exceção é se o parâmetro InMemory for especificado na chamada a este cmdlet. Este comando criará um objeto somente em memória que contém uma lista padrão das rotas de voz.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

XdsIdentity

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

Route

Opcional

PSListModifier

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

É possível criar objetos de rotas de voz utilizando-se o cmdlet New-CsVoiceRoute. Está é a maneira recomendada para adicionar rotas de voz para esta lista.

Force

Opcional

SwitchParameter

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

InMemory

Opcional

SwitchParameter

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

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

Nenhuma.

Tipos de Retorno

Pode criar um objeto em memória do tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnRoutingSettings.

Exemplo

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

$x = New-CsRoutingConfiguration -Identity global -InMemory

Este comando cria um objeto que contém valores de configuração de roteamento padrão e atribui esse objeto à variável $x. Qualquer outro uso deste cmdlet retornará um erro.