Remove-CsVoiceRoute
Ultima modifica dell'argomento: 2012-03-25
Rimuove una route vocale. Le route vocali contengono istruzioni che comunicano a Microsoft Lync Server 2010 come instradare le chiamate effettuate da utenti di VoIP aziendale ai numeri di telefono della rete PSTN (Public Switched Telephone Network) o di un centralino (PBX, Private Branch Exchange).
Sintassi
Remove-CsVoiceRoute -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Utilizzare questo cmdlet per rimuovere una route vocale esistente. Le route vocali sono associate ai criteri vocali per mezzo degli utilizzi PSTN, pertanto la rimozione di una route vocale non provoca cambiamenti nei valori relativi a un criterio vocale; modifica semplicemente il routing per i numeri corrispondenti al modello della route vocale eliminata.
Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Remove-CsVoiceRoute 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-CsVoiceRoute"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
XdsGlobalRelativeIdentity |
Una stringa che identifica in modo univoco la route vocale da eliminare. Se il nome della route contiene uno spazio, come nel caso di Test Route, è necessario racchiudere l'intera stringa tra virgolette doppie. |
Force |
Facoltativo |
Parametro opzionale |
Elimina qualsiasi richiesta di conferma che, in caso contrario, sarebbe visualizzata prima di effettuare le modifiche. |
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.Policy.Voice.Route. Consente di accettare l'input da pipeline di oggetti route vocale.
Tipi restituiti
Consente di rimuovere un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Policy.Voice.Route.
Esempio
-------------------------- Esempio 1 --------------------------
Remove-CsVoiceRoute -Identity Route1
Consente di rimuovere le impostazioni per la route vocale con identità Route1.
-------------------------- Esempio 2 --------------------------
Get-CsVoiceRoute | Remove-CsVoiceRoute
Questo comando consente di rimuovere tutte le route vocali dall'organizzazione. Per prima cosa vengono recuperate tutte le route vocali dal cmdlet Get-CsVoiceRoute. Queste route vocali vengono quindi inviate tramite pipe a Remove-CsVoiceRoute, che rimuove ogni route.
-------------------------- Esempio 3 --------------------------
Get-CsVoiceRoute -Filter *Redmond* | Remove-CsVoiceRoute
Questo comando consente di rimuovere tutte le route vocali la cui identità contiene la stringa "Redmond". Per prima cosa viene chiamato il cmdlet Get-CsVoiceRoute con il parametro Filter. Il valore del parametro Filter è la stringa Redmond preceduta e seguita da caratteri jolly (*), che specificano che la stringa può trovarsi in qualunque posizione all'interno di Identity. Una volta recuperate tutte le route vocali la cui identità contiene la stringa Redmond, queste route vocali vengono inviate tramite pipe a Remove-CsVoiceRoute, che rimuove ogni route.