Condividi tramite

  • Articolo

Get-CsStaticRoutingConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce informazioni sulle impostazioni di configurazione del routing statico in uso nell'organizzazione.

Sintassi

Get-CsStaticRoutingConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsStaticRoutingConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrizione dettagliata

Quando si invia un messaggio SIP, il messaggio potrebbe dover attraversare molteplici subnet e reti prima di essere recapitato; il percorso seguito dal messaggio è spesso definito route. Nelle reti esistono due tipi di route: dinamiche e statiche. Con il routing dinamico, i server utilizzano algoritmi per determinare la posizione successiva (vale a dire l'hop successivo) a cui dovrebbe essere inoltrato un messaggio. Con il routing statico, i percorsi seguiti dai messaggi sono determinati anticipatamente dagli amministratori di sistema. Quando riceve un messaggio, il server controlla l'indirizzo del messaggio e inoltra il messaggio stesso al server dell'hop successivo configurato anticipatamente da un amministratore. Se la configurazione è corretta, le route statiche aiutano a garantire un recapito tempestivo e accurato dei messaggi, applicando un sovraccarico minimo sui server. Lo svantaggio delle route statiche è dovuto al fatto che i messaggi non vengono reinstradati in modo dinamico se si verifica un errore di rete.

Quando si installa Microsoft Lync Server 2010, viene automaticamente creata una raccolta globale di route statiche. Le route non vengono tuttavia assegnate alla raccolta creata. Inoltre, il software permette di creare raccolte aggiuntive applicate all'ambito del servizio (queste nuove raccolte possono essere assegnate esclusivamente al servizio di registrazione). Il cmdlet Get-CsStaticRoutingConfiguration consente di restituire informazioni su tutte le raccolte di configurazione del routing statico in uso nell'organizzazione. È compresa la possibilità di restituire informazioni dettagliate su ciascuna route assegnata a una raccolta.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Get-CsStaticRoutingConfiguration in locale: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

Identificatore univoco per la raccolta di configurazione di routing statico. Per restituire informazioni sulla raccolta globale, utilizzare la seguente sintassi: -Identity global. Per recuperare informazioni su una raccolta configurata nell'ambito del servizio, utilizzare una sintassi simile a quella riportata di seguito: -Identity "service:Registrar:atl-cs-001.litwareinc.com". Si noti che non è possibile utilizzare i caratteri jolly quando si specifica un parametro Identity. Tuttavia, se è necessario utilizzare caratteri jolly, utilizzare il parametro Filter.

Se non si includono i parametri Identity o Filter, Get-CsStaticRoutingConfiguration restituisce informazioni su tutte le raccolte di configurazione del routing statico.

Filter

Facoltativo

Stringa

Consente di utilizzare i caratteri jolly per specificare la raccolta (o le raccolte) di configurazione del routing statico da restituire. Ad esempio, la sintassi riportata di seguito restituisce tutte le raccolte di routing statico configurate nell'ambito del servizio: -Filter "service:*".

Non è possibile utilizzare i parametri Filter e Identity nello stesso comando.

LocalStore

Facoltativo

Parametro opzionale

Consente di recuperare i dati di configurazione del routing statico dalla replica locale dell'archivio di gestione centrale anziché dall'archivio di gestione centrale stesso.

Tipi di input

Nessuno. Get-CsStaticRoutingConfiguration non accetta l'input da pipeline.

Tipi restituiti

Get-CsStaticRoutingConfiguration restituisce le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings.

Esempio

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

Get-CsStaticRoutingConfiguration

Con il comando mostrato nell'esempio 1 vengono restituite le informazioni su tutte le raccolte di configurazione del routing statico in uso nell'organizzazione.

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

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

Con l'esempio 2 vengono restituite informazioni su una singola raccolta di configurazione del routing statico, la raccolta con identità service:Registrar:atl-cs-001.litwareinc.com.

-------------------------- Esempio 3 ------------------------

Get-CsStaticRoutingConfiguration -Filter "service:*"

Con l'esempio 3 viene utilizzato il parametro Filter per restituire informazioni sulle raccolte di configurazione del routing statico assegnate nell'ambito del servizio. Il valore del filtro "service:*" limita i dati restituiti alle raccolte con un'identità che inizia con il valore stringa "service:"

-------------------------- Esempio 4 ------------------------

Get-CsStaticRoutingConfiguration | Select-Object -ExpandProperty Route

Con il comando precedente vengono restituite informazioni dettagliate sulle route per tutte le raccolte di configurazione del routing statico in uso nell'organizzazione. Per ottenere tale risultato, il comando chiama per prima cosa Get-CsStaticRoutingConfiguration senza parametri per restituire le informazioni complete per ogni raccolta di routing statico. Queste informazioni vengono quindi inviate tramite pipe al cmdlet Select-Object, che utilizza il parametro ExpandProperty per "espandere" il valore della proprietà Route. Quando si espande una proprietà, tutti gli oggetti e i valori contenuti nella proprietà vengono visualizzati sullo schermo in un modo di facile lettura.

-------------------------- Esempio 5 ------------------------

Get-CsStaticRoutingConfiguration | Select-Object -ExpandProperty Route | Where-Object {$_.MatchOnlyPhoneUri -eq $True}

Con il comando illustrato nell'esempio 5 vengono restituite informazioni su tutte le route statiche configurate per corrispondere solamente a URI di telefonia. Per eseguire questa operazione, il comando chiama innanzitutto Get-CsStaticRoutingConfiguration senza parametri per restituire tutte le raccolte di configurazione di routing statico con le route associate. La raccolta viene quindi inviata tramite pipe al cmdlet Select-Object, che utilizza il parametro ExpandProperty per espandere tutti gli oggetti archiviati nella proprietà Route. Questi oggetti route vengono quindi inviati tramite pipe al cmdlet Where-Object, che recupera solo le route la cui proprietà MatchOnlyPhoneUri equivale a True.