• Articolo

Remove-CsConferenceDirectory

 

Ultima modifica dell'argomento: 2012-03-25

Rimuove una directory conferenza esistente. Le directory conferenza consentono agli utenti delle conferenze telefoniche con accesso esterno di individuare le informazioni relative alle conferenze.

Sintassi

Remove-CsConferenceDirectory -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Quando si crea un URI (Uniform Resource Identifier) di conferenza telefonica con accesso esterno, a tale URI viene assegnato un indirizzo SIP univoco. Gli indirizzi SIP tuttavia sono difficili da interpretare nei dispositivi che non supportano il protocollo SIP. Un telefono di una rete PSTN (Public Switched Telephone Network) ad esempio non è in grado di interpretare un indirizzo SIP. Per questo motivo, in Microsoft Lync Server 2010 vengono utilizzate le directory conferenza per semplificare l'individuazione e la connessione alle conferenze telefoniche con accesso esterno da parte di tali dispositivi. Per questo scopo si crea una directory conferenze SIP associata a ogni URI di conferenza telefonica con accesso esterno e identificata da un valore intero anziché da un URI SIP. I telefoni PSTN e altri dispositivi possono quindi utilizzare questi numeri (anziché un URI SIP) quando si connettono alle conferenze. Il numero della directory infatti viene incluso nell'ID conferenza PSTN immesso dagli utenti quando si connettono a una conferenza telefonica con accesso esterno.

Le directory conferenza vengono create utilizzando il cmdlet New-CsConferenceDirectory. Potrebbe essere necessario a volte eliminare una o più di queste directory, ad esempio rimuovere il pool in cui sono ospitate. Le directory conferenza possono essere rimosse chiamando il cmdlet Remove-CsConferenceDirectory. Se si desidera solo spostare una directory da un pool a un altro, è possibile chiamare il cmdlet Move-CsConferenceDirectory.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Remove-CsConferenceDirectory i membri dei seguenti gruppi: RTCUniversalServerAdmins. 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-CsConferenceDirectory"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Identità XDS

Identità numerica della directory conferenza da rimuovere.

Force

Facoltativo

Parametro opzionale

Se presente, rimuove la directory conferenza anche se il pool che ospita la directory non è attualmente disponibile. Per impostazione predefinita, Remove-CsConferenceDirectory non rimuoverà le directory se non è possibile contattare il pool corrispondente.

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.PstnConf.ConferenceDirectories. Remove-CsConferenceDirectory accetta l'input da pipeline di oggetti directory conferenza.

Tipi restituiti

Nessuno. Removes-CsConferenceDirectory piuttosto elimina le istanze dell'oggetto Microsoft.Rtc.Management.WritableConfig.Settings.PstnConf.ConferenceDirectories.

Esempio

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

Remove-CsConferenceDirectory -Identity 2

Il comando riportato nell'esempio 1 elimina la directory conferenza con valore Identity 2.

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

Get-CsConferenceDirectory | Where-Object {$_.ServiceID -match "UserServer:atl-cs-001.litwareinc.com"} | Remove-CsConferenceDirectory

Con il comando precedente vengono eliminate tutte le directory conferenza rilevate nel servizio UserServer:atl-cs-001.litwareinc.com. A tale scopo, il comando chiama innanzitutto Get-CsConferenceDirectory senza alcun parametro. Quest'ultimo restituisce una raccolta di tutte le directory conferenza attualmente in uso nell'organizzazione. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona solo le directory ospitate nel servizio UserServer:atl-cs-001.litwareinc.com. A sua volta, la raccolta filtrata viene inviata tramite pipe al cmdlet Remove-CsConferenceDirectory, che la elimina.