Condividi tramite

  • Articolo

Remove-CsDialPlan

 

Ultima modifica dell'argomento: 2012-03-25

Rimuove il dial plan specificato. Questo cmdlet può essere utilizzato anche per rimuovere il dial plan globale. Se si rimuove il dial plan globale, però, il dial plan non viene effettivamente rimosso; in realtà, le impostazioni vengono semplicemente riportate ai valori predefiniti.

Sintassi

Remove-CsDialPlan -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Questo cmdlet consente di rimuovere un dial plan esistente (detto anche profilo di numerazione locale). I dial plan forniscono informazioni necessarie per consentire agli utenti di VoIP aziendale di effettuare telefonate. I dial plan sono utilizzati anche da applicazione Operatore Conferenza per le conferenze telefoniche con accesso esterno. Un dial plan determina le regole di normalizzazione applicate e se è necessario comporre un prefisso per le chiamate esterne.

Nota: La rimozione di un dial plan comporta anche la rimozione di eventuali regole di normalizzazione associate. Se viene rimosso il dial plan globale vengono rimosse anche eventuali regole di normalizzazione associate, ma viene creata una regola di normalizzazione globale predefinita.

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Identità XDS

L'identificatore univoco del dial plan che si desidera rimuovere.

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.LocationProfile. Remove-CsDialPlan consente di accettare l'input da pipeline di oggetti dial plan.

Tipi restituiti

Il cmdlet rimuove le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile.

Esempio

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

Remove-CsDialPlan -Identity RedmondDialPlan

Con l'esempio precedente viene utilizzato Remove-CsDialPlan per eliminare il dial plan per utente con Identity RedmondDialPlan. Si noti che quando si elimina un dial plan non è necessario assegnare un nuovo dial plan agli utenti in precedenza assegnati al dial plan eliminato. Questi utenti utilizzeranno il dial plan assegnato al loro servizio o sito, oppure il dial plan globale.

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

Get-CsDialPlan | Where-Object {$_.Description -match "Redmond"} | Remove-CsDialPlan

Con l'esempio 2 vengono eliminati tutti i dial plan che includono la parola Redmond nella loro descrizione. Per ottenere tale risultato, il comando chiama per prima cosa Get-CsDialPlan per restituire una raccolta di tutti i dial plan configurati per l'uso nell'organizzazione. Tale raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che applica un filtro per limitare i dati restituiti ai profili che includono la parola Redmond nella loro descrizione. Successivamente, la raccolta filtrata viene passata a Remove-CsDialPlan, che procede all'eliminazione di tutti i dial plan nella raccolta.