Condividi tramite

  • Articolo

Remove-CsVoicePolicy

 

Ultima modifica dell'argomento: 2012-03-24

Consente di rimuovere il criterio vocale specificato.

Sintassi

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

Descrizione dettagliata

Questo cmdlet consente di rimuovere un criterio vocale esistente. I criteri vocali sono utilizzati per gestire le funzionalità di VoIP aziendale, ad esempio lo squillo simultaneo (vale a dire la capacità di far squillare un secondo telefono ogni volta che si riceve una chiamata sul telefono dell'ufficio) e l'inoltro di chiamata. Questo cmdlet può essere utilizzato anche per rimuovere il criterio vocale globale. In questo caso, però, i criteri non vengono effettivamente rimossi, ma per tutte le proprietà dei criteri verranno ripristinati i valori predefiniti.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Remove-CsVoicePolicy 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 "Remove-CsVoicePolicy"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

Un identificatore univoco che specifica l'ambito e, in alcuni casi il nome, del criterio da rimuovere.

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione delle richieste di conferma che altrimenti verrebbero visualizzate prima che vengano apportate 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.VoicePolicy. Accetta input tramite pipeline da oggetti criterio vocale.

Tipi restituiti

Questo cmdlet non restituisce un valore. Consente di rimuovere un'istanza di un oggetto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.VoicePolicy.

Esempio

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

Remove-CsVoicePolicy -Identity UserVoicePolicy1

In questo esempio vengono rimosse le impostazioni del criterio vocale per utente UserVoicePolicy1.

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

Get-CsVoicePolicy -Filter tag* | Remove-CsVoicePolicy

In questo esempio vengono rimosse tutte le impostazioni dei criteri vocali che possono essere assegnate a utenti specifici. Il comando utilizza il cmdlet Get-CsVoicePolicy con il valore tag* per il parametro Filter in modo da ottenere tutti i criteri vocali per utente. La raccolta di criteri viene quindi inviata tramite pipe al cmdlet Remove-CsVoicePolicy per la rimozione.