Condividi tramite

  • Articolo

New-CsRoutingConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Questo cmdlet può restituire un oggetto contenente le impostazioni predefinite per un oggetto di configurazione di routing.

Sintassi

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

Descrizione dettagliata

Una configurazione di routing è un contenitore di tutte le route vocali definite all'interno di una distribuzione di Microsoft Lync Server 2010. Per creare una nuova route vocale, utilizzare il cmdlet New-CsVoiceRoute.

Una configurazione di routing può essere definita solo a livello globale. Inoltre, non è possibile denominare singolarmente le configurazioni di routing; è disponibile solo un elenco di route vocali per l'intera distribuzione di Lync Server 2010. Nell'implementazione Lync Server 2010 di Windows PowerShell, se si tenta di creare un oggetto già esistente chiamando un cmdlet che inizia con il verbo New, verrà restituito un messaggio di errore. Ogni implementazione di Lync Server 2010 include un oggetto di configurazione di routing predefinito con valore Identity Global. Ciò significa che l'unico elenco di route vocali che potrebbe essere creato, esiste già. Di conseguenza, una chiamata a New-CsRoutingConfiguration restituirà un messaggio di errore e non creerà una nuova configurazione di routing.

La sola eccezione si presenta quando si specifica il parametro InMemory durante la chiamata del cmdlet. Questo comando creerà un oggetto solo in memoria che contiene un elenco predefinito di route vocali.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet New-CsRoutingConfiguration i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Identità XDS

L'ambito della configurazione di routing. Questo valore deve essere Global.

Route

Facoltativo

PSListModifier

Un elenco di tutte le route vocali (oggetti Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route) definite per la distribuzione di Lync Server 2010.

È possibile creare oggetti route vocali utilizzando il cmdlet New-CsVoiceRoute. Questo è il metodo consigliato per l'aggiunta di route vocali in questo elenco.

Force

Facoltativo

Parametro opzionale

Elimina qualsiasi richiesta di conferma che, in caso contrario, sarebbe visualizzata prima di effettuare le modifiche.

InMemory

Facoltativo

Parametro opzionale

Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente.

WhatIf

Facoltativo

Parametro opzionale

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Confirm

Facoltativo

Parametro opzionale

Viene visualizzata una richiesta di conferma prima di eseguire il comando.

Tipi di input

Nessuno.

Tipi restituiti

È in grado di creare un oggetto in memoria di tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.PstnRoutingSettings.

Esempio

-------------------------- Esempio 1 --------------------------

$x = New-CsRoutingConfiguration -Identity global -InMemory

Questo comando crea un oggetto che contiene i valori di configurazione di routing predefiniti e assegna tale oggetto alla variabile $x. Qualsiasi altro utilizzo di questo cmdlet restituirà un errore.