• Articolo

Remove-CsExUmContact

 

Ultima modifica dell'argomento: 2012-03-25

Rimuove un oggetto contatto per Operatore automatico o Accesso sottoscrittore per il servizio Messaggistica unificata di Exchange ospitato.

Sintassi

Remove-CsExUmContact -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Microsoft Lync Server 2010 collabora con Messaggistica unificata di Exchange per fornire diverse funzionalità vocali, tra cui Operatore automatico e Accesso sottoscrittore. Quando Messaggistica unificata di Exchange viene fornito come servizio ospitato (anziché locale), è necessario creare oggetti contatto mediante Windows PowerShell per applicare le funzionalità Operatore automatico e Accesso sottoscrittore. Tutti gli oggetti creati possono essere rimossi con il cmdlet Remove-CsExUmContact.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Remove-CsExUmContact i membri dei seguenti gruppi: RTCUniversalUserAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsExUmContact"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

UserIDParameter

L'identificatore univoco dell'oggetto contatto che si desidera rimuovere. Le identità dei contatti possono essere specificate utilizzando uno dei quattro formati seguenti: 1) L'indirizzo SIP del contatto; 2) il nome dell'entità utente (UPN) del contatto; 3) il nome del dominio del contatto e il nome di accesso nella forma dominio\accesso (ad esempio, litwareinc\exum1); infine, 4) il nome di visualizzazione Active Directory del contatto (ad esempio, Team Auto Attendant).

Tipo di dati completi: Microsoft.Rtc.Management.AD.UserIdParameter

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.ADConnect.Schema.OCSADExUmContact. Accetta l'input da pipeline di oggetti contatto di Messaggistica unificata di Exchange.

Tipi restituiti

Questo cmdlet non restituisce un oggetto. Rimuove un oggetto di tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADExUmContact.

Esempio

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

Remove-CsExUmContact -Identity sip:exumsa1@fabrikam.com

In questo esempio viene rimosso il contatto Messaggistica unificata di Exchange con indirizzo SIP exumsa1@fabrikam.com.

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

Get-CsExUmContact -Filter {LineURI -like "tel:425*"} | Remove-CsExUmContact

Questo esempio rimuove tutti i contatti Messaggistica unificata di Exchange con i valori LineURI che iniziano con 425. La prima parte di questo comando chiama il cmdlet Get-CsExUmContact con il parametro Filter utilizzando questa espressione come filtro: LineURI -like "tel:425*". Il filtro specifica che si desidera recuperare gli oggetti contatto Messaggistica unificata di Exchange che hanno un valore LineURI che corrisponde alla stringa carattere jolly 425\*. In altri termini, tutti gli URI linea che iniziano con la stringa 425 e finiscono con qualsiasi insieme di caratteri. Dopo aver raccolto questi oggetti, la raccolta viene inviata tramite pipe al cmdlet Remove-CsExUmContact che rimuove tutti gli elementi presenti nella raccolta.