Condividi tramite

  • Articolo

New-CsStaticRoutingConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Consente di creare una nuova raccolta di impostazioni di configurazione del routing statico.

Sintassi

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

Descrizione dettagliata

Quando si invia un messaggio SIP a qualcuno, quel messaggio potrebbe dover attraversare più subnet e reti prima di essere consegnato; il percorso effettuato dal messaggio viene spesso chiamato "route". Nelle reti, esistono due tipi di route: dinamiche e statiche. Con le route dinamiche, i server utilizzano algoritmi per stabilire la prossima destinazione (prossimo hop) dove inoltrare il messaggio. Con le route statiche, il percorso del messaggio viene stabilito a priori dagli amministratori di sistema. Quando un messaggio viene ricevuto da un server, questo controlla l'indirizzo del messaggio e lo inoltra al prossimo server che è stato preconfigurato da un amministratore. Se configurate correttamente le route statiche aiutano ad assicurare una tempestiva ed accurata consegna del messaggio senza sovraccarico sul server. Lo svantaggio delle route statiche è rappresentato dal fatto che i messaggi non vengono dinamicamente reinstradati nel caso di un errore di rete.

Quando si installa Microsoft Lync Server 2010, viene automaticamente creata una raccolta globale di route statiche. In aggiunta a questo, è possibile utilizzare il cmdlet New-CsStaticRoutingConfiguration per creare raccolte aggiuntive nell'ambito del sito o del servizio (solo per il servizio Registrar).

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet New-CsStaticRoutingConfiguration può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

Identificatore univoco della nuova raccolta di route statiche da creare. Le nuove raccolte possono essere create solo nell'ambito di servizio e possono essere assegnate solo al servizio di registrazione. A causa di ciò, la Identity di una nuova raccolta sarà simile a questa: -Identity "service:Registrar:atl-cs-001.litwareinc.com".

Route

Facoltativo

PSList Modifier

Route statiche individuali gestite nella raccolta. Le route che devono essere aggiunte a una raccolta possono essere o copiate da un'altra raccolta o create usando il cmdlet New-CsStaticRoute. Per informazioni dettagliate, vedere gli esempi in questo argomento.

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando.

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. New-CsStaticRoutingConfiguration non accetta input tramite pipeline.

Tipi restituiti

New-CsStaticRoutingConfiguration crea nuove istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings.

Esempio

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

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

Il comando precedente consente di creare una nuova raccolta di configurazione di route statiche con identità service:Registrar:atl-cs-001.litwareinc.com. Poiché nel comando non è stato incluso il parametro Route, alla nuova raccolta non verrà assegnata nessuna route statica.

-------------------------- Esempio 2 --------------------------

$x = New-CsStaticRoute -TCPRoute -Destination "192.168.0.100" -Port 8025 -MatchUri "*.litwareinc.com"

New-CsStaticRoutingConfiguration -Identity "service:Registrar:atl-cs-001.litwareinc.com" -Route $x

Il comando riportato nell'Esempio 2 consente di creare un nuovo proxy SIP di routing che usa TCP come trasporto; questa nuova route viene poi aggiunta a una nuova raccolta di configurazione di route statiche. Per fare ciò, il primo comando nell'esempio utilizza New-CsStaticRoute per creare una nuova route che punta al prossimo server hop con indirizzo IP 192.168.1.100. Questa nuova route (memorizzata in una variabile nominata $x) utilizza anche la porta 8025 e il MatchUri "*.litwareinc.com".

Viene quindi utilizzato il cmdlet New-CsStaticRoutingConfiguration per creare una nuova raccolta (con identità service:Registrar:atl-cs-001.litwareinc.com), assegnando la route memorizzata nella variabile $X alla proprietà Route della nuova raccolta.