Set-CsStaticRoutingConfiguration
Ultima modifica dell'argomento: 2012-03-26
Modifica una raccolta esistente di impostazioni di configurazione del routing statico.
Sintassi
Set-CsStaticRoutingConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Route <PSListModifier>] [-WhatIf [<SwitchParameter>]]
Set-CsStaticRoutingConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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) in cui 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. La raccolta viene creata ma non ci sono route assegnate a questa raccolta. In aggiunta, il software consente di creare raccolte aggiuntive applicate all'ambito di servizio (queste nuove raccolte possono essere assegnate solo al servizio di registrazione). Il cmdlet Set-CsStaticRoutingConfiguration consente di modificare i valori delle proprietà in una raccolta esistente di routing statico. Ciò significa che è possibile utilizzare il cmdlet per aggiungere nuove route alla raccolta o eliminare route dalla raccolta.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Set-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 "Set-CsStaticRoutingConfiguration"}
Parametri
Parametro | Obbligatorio | Tipo | Descrizione |
---|---|---|---|
Identity |
Facoltativo |
XdsIdentity |
Identificatore univoco della raccolta di configurazione di route statiche da modificare. Per modificare la raccolta globale, utilizzare la seguente sintassi: -Identity global. Per modificare una raccolta applicata nell'ambito del servizio, utilizzare una sintassi simile alla seguente: -Identity "service:Registrar:atl-cs-001.litwareinc.com". Non è consentito utilizzare i caratteri jolly per specificare l'identità. Se non viene incluso questo parametro, Set-CsStaticRoutingConfiguration modificherà automaticamente la raccolta globale. |
Instance |
Facoltativo |
Oggetto RoutingSettings |
Consente di passare al cmdlet un riferimento a un oggetto anziché impostare singoli valori di parametro. |
Route |
Facoltativo |
Modificatore dell'elenco PS |
Route statiche individuali gestite nella raccolta. Le route da aggiungere ad una raccolta possono essere copiate da un'altra raccolta o create utilizzando il cmdlet New-CsStaticRoute per eliminare una route da una raccolta si deve prima creare un oggetto di riferimento a quella route. Per informazioni dettagliate, vedere la sezione 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. |
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. Set-CsStaticRoutingConfiguration accetta le istanze inviate tramite pipeline dell'oggetto impostazioni proxy.
Tipi restituiti
Set-CsStaticRoutingConfiguration non restituisce alcun oggetto o valore. Il cmdlet configura invece le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings.
Esempio
-------------------------- Esempio 1 --------------------------
$x = Get-CsStaticRoutingConfiguration -Identity global | Select-Object -ExpandProperty Route | Where-Object {$_.MatchUri -eq "litwareinc.com" -and $_.MatchOnlyPhoneUri -eq $True}
Set-CsStaticRoutingConfiguration -Identity service:Registrar:atl-cs-001.litwareinc.com -Route @{Add=$x}
Il comando riportato nell'Esempio 1 consente di copiare una route da una raccolta di route statiche globale e poi di assegnare quella route ad una seconda raccolta di route statiche, quella con l'identità service:Registrar:atl-cs-001.litwareinc.com. Per completare questa attività, il primo comando nell'esempio si collega alla raccolta globale e restituisce un oggetto di riferimento alle route con MatchUri litwareinc.com e MatchOnlyPhoneUri uguali a a True.
Per ottenere questo risultato, il comando utilizza Get-CsStaticRoutingConfiguration per restituire informazioni dalla raccolta di configurazioni del routing statico nell'ambito globale. Questi dati vengono quindi inviati tramite pipe al Select-Object che utilizza il parametro ExpandProperty per espandere il valore della proprietà Route. Il valori espansi (che rappresentano la route assegnata alla raccolta) vengono inviati tramite pipe al cmdlet Where-Object che seleziona solo quelle route in cui la proprietà MatchUri è uguale a litwareinc.com e la proprietà MatchOnlyPhoneUri è uguale a True. La route restituita viene memorizzata in una variabile denominata $x.
Dopo aver recuperato la route il secondo comando nell'esempio, la aggiunge alla raccolta service: Registrar:atl-cs-001.litwareinc.com. Per ottenere questo risultato, viene utilizzato Set-CsStaticRoutingConfiguration con il parametro Route; il valore del parametro @{Add=$x} comunica a Set-CsStaticRoutingConfiguration di aggiungere la route memorizzata nella variabile $x alla raccolta contenuta nella proprietà Route.
-------------------------- Esempio 2 --------------------------
$x = Get-CsStaticRoutingConfiguration -Identity service:Registrar:atl-cs-001.litwareinc.com | Select-Object -ExpandProperty Route | Where-Object {$_.MatchUri -eq "litwareinc.com" -and $_.MatchOnlyPhoneUri -eq $True}
Set-CsStaticRoutingConfiguration -Identity service:Registrar:atl-cs-001.litwareinc.com -Route @{Remove=$x}
Il comando precedente elimina una route da una raccolta di route statiche. Per completare questa attività, il primo comando nell'esempio si connette alla raccolta con identità service:Registrar:atl-cs-001.litwareinc.com e restituisce un oggetto di riferimento alle route con MatchUri litwareinc.com e MatchOnlyPhoneUri uguali a True. Per ottenere questo risultato, il comando utilizza Get-CsStaticRoutingConfiguration per restituire informazioni dalla raccolta service:Registrar:atl-cs-001.litwareinc.com. Questi dati vengono quindi inviati tramite pipe al Select-Object che utilizza il parametro ExpandProperty per espandere il valore della proprietà Route. Il valori espansi (che rappresentano la route assegnata alla raccolta) vengono inviati tramite pipe al cmdlet Where-Object che seleziona solo quelle route in cui la proprietà MatchUri è uguale a litwareinc.com e la proprietà MatchOnlyPhoneUri è uguale a True. La route restituita viene memorizzata in una variabile denominata $x.
Dopo aver recuperato la route, il secondo comando elimina quella route dalla raccolta. Per ottenere questo risultato, vien utilizzato Set-CsStaticRoutingConfiguration assieme al parametro Route; il valore del parametro @{Remove=$x} indica a Set-CsStaticRoutingConfiguration di eliminare la route specificata nella variabile $x.
-------------------------- Esempio 3 --------------------------
Set-CsStaticRoutingConfiguration -Identity service:Registrar:atl-cs-001.litwareinc.com -Route $Null
L'Esempio 3 mostra come rimuovere tutte route assegnate ad una raccolta di configurazione di route statiche. Per ottenere questo risultato, includere il parametro Route ed impostare il suo valore su null. Al termine del comando, la raccolta esiste ancora ma nessuna route è rimasta assegnata a questa raccolta.
Vedere anche
Ulteriori risorse
Get-CsStaticRoutingConfiguration
New-CsStaticRoute
New-CsStaticRoutingConfiguration
Remove-CsStaticRoutingConfiguration