Condividi tramite

  • Articolo

Remove-CsStaticRoutingConfiguration

 

Ultima modifica dell'argomento: 2012-03-25

Consente di rimuovere la raccolta specificata delle impostazioni di configurazione di routing statico.

Sintassi

Remove-CsStaticRoutingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<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). Se in seguito si cambia idea, è possibile utilizzare il cmdlet Remove-CsStaticRoutingConfiguration per eliminare le raccolte applicate nell'ambito del servizio.

Il cmdlet Remove-CsStaticRoutingConfiguration può anche essere eseguito sulla raccolta globale. In questo caso, però, la raccolta globale non viene rimossa, perché Lync Server 2010 non consente di rimuovere le raccolte globali. Tuttavia, tutte le proprietà della raccolta globale vengono ripristinate ai valori predefiniti. Significa che tutte le route assegnate alla raccolta globale saranno eliminate.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Remove-CsStaticRoutingConfiguration in locale: 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 "Remove-CsStaticRoutingConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Identità XDS

Identificatore univoco della raccolta di configurazione del routing statico da rimuovere. Per rimuovere una raccolta configurata nell'ambito del servizio, utilizzare una sintassi simile a quella riportata di seguito: -Identity "service:Registrar:atl-cs-001.litwareinc.com".

Remove-CsStaticRoutingConfiguration può essere eseguito anche sulla raccolta globale; a tal fine, utilizzare la sintassi riportata di seguito: -Identity global. Occorre ricordare, però, che la raccolta globale non sarà effettivamente eliminata. In realtà le proprietà nella raccolta vengono ripristinate ai valori predefiniti. Significa che tutti gli elementi nella proprietà Route saranno eliminati.

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.

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

Oggetto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings. Remove-CsStaticRoutingConfiguration consente di accettare le istanze da pipeline dell'oggetto impostazioni di routing statico.

Tipi restituiti

Remove-CsStaticRoutingConfiguration non restituisce alcun oggetto o valore. Il cmdlet, invece, consente di eliminare le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings.

Esempio

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

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

Con il comando nell'esempio 1 viene rimossa la raccolta di configurazione del routing statico con identità service:Registrar:atl-cs-001.litwareinc.com.

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

Get-CsStaticRoutingConfiguration -Filter "service:*" | Remove-CsStaticRoutingConfiguration

Con l'esempio 2 vengono rimosse tutte le raccolte di configurazione del routing statico applicate nell'ambito del servizio. Per eseguire questa operazione, il comando utilizza inizialmente Get-CsStaticRoutingConfiguration con il parametro Filter; il valore del filtro "service:*" limita i dati restituiti alle raccolte in cui l'identità inizia con il valore stringa "service:". La raccolta filtrata viene quindi inviata tramite pipe al cmdlet Remove-CsStaticRoutingConfiguration che elimina ogni elemento presente nella raccolta.

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

Get-CsStaticRoutingConfiguration | Where-Object {$_.Route.Count -eq 0} | Remove-CsStaticRoutingConfiguration

Con l'esempio 3 viene mostrato come eliminare tutte le raccolte di configurazione del routing statico a cui non sono assegnate route effettive. Per eseguire questa operazione, il comando chiama per prima cosa Get-CsStaticRoutingConfiguration per restituire le informazioni su tutte le raccolte di routing statico in uso nell'organizzazione. La raccolta viene inviata tramite pipe al cmdlet Where-Object, che recupera solo le raccolte in cui il numero di route (Route.Count) è uguale a 0. Le informazioni filtrate vengono quindi inviate tramite pipe a Remove-CsStaticRoutingConfiguration, che elimina ciascuna raccolta a cui non è stata assegnata almeno una route.