Condividi tramite

  • Articolo

Remove-CsDialInConferencingAccessNumber

 

Ultima modifica dell'argomento: 2012-03-25

Rimuove un numero di accesso esistente per le conferenze telefoniche con accesso esterno. Le conferenze telefoniche con accesso esterno consentono agli utenti di utilizzare un normale telefono o cellulare (ovvero un dispositivo nella rete PSTN) per partecipare alla parte audio di una conferenza.

Sintassi

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

Descrizione dettagliata

Le conferenze telefoniche con accesso esterno consentono agli utenti di utilizzare qualsiasi tipo di telefono, ad esempio una linea terrestre standard, un telefono cellulare o un telefono VoIP, per partecipare alla parte audio di una conferenza. In questo modo è possibile partecipare alla riunione anche non disponendo di un computer o di una connessione Internet. Gli utenti dispongono delle funzionalità audio complete: possono parlare con altri partecipanti e ascoltare tutto. Non sono invece in grado di visualizzare diapositive condivise, trasmissioni video o altri elementi visivi.

Per offrire agli utenti le funzionalità di conferenza telefonica con accesso esterno, è necessario creare numeri di accesso alle conferenze telefoniche con accesso esterno, ovvero dei numeri telefonici che gli utenti chiamano per collegarsi alla riunione. I numeri di accesso alle conferenze telefoniche con accesso esterno vengono creati utilizzando il cmdlet New-CsDialInConferencingAccessNumber. Quando si crea un nuovo numero di accesso alle conferenze telefoniche con accesso esterno, si crea in realtà un nuovo oggetto contatto in Servizi di dominio Active Directory. L'oggetto contatto viene utilizzato per rappresentare il numero di accesso e tutte le relative proprietà. Il cmdlet Remove-CsDialInConferencingAccessNumber consente di eliminare qualunque numero di accesso alle conferenze telefoniche con accesso esterno creato tramite New-CsDialInConferencingAccessNumber. Se si esegue Remove-CsDialInConferencingAccessNumber, il cmdlet non elimina solo il numero dalla raccolta di numeri di accesso alle conferenze telefoniche con accesso esterno, ma anche l'oggetto contatto Active Directory che rappresenta tale numero.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Remove-CsDialInConferencingAccessNumber 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-CsDialInConferencingAccessNumber"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Indirizzo SIP

L'indirizzo SIP del numero di accesso alle conferenze telefoniche con accesso esterno (ovvero l'oggetto contatto che rappresenta tale numero) da rimuovere. È necessario includere il prefisso sip: quando si specifica il valore Identity, ad esempio -Identity "sip:RedmondDialIn@litwareinc.com".

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.Xds.AccessNumber. Remove-CsDialInConferencingAccessNumber accetta l'input da pipeline dell'oggetto numero di accesso.

Tipi restituiti

Remove-CsDialInConferencingAccessNumber elimina le istanze dell'oggetto Microsoft.Rtc.Management.Xds.AccessNumber.

Esempio

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

Remove-CsDialInConferencingAccessNumber -Identity sip:RedmondDialIn@litwareinc.com

Il comando mostrato nell'esempio 1 elimina il numero di accesso per le conferenze telefoniche con accesso esterno con Identity sip:RedmondDialIn@litwareinc.com.

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

Get-CsDialInConferencingAccessNumber -Filter {LineUri -like "tel:+1800*"} | Remove-CsDialInConferencingAccessNumber

Il comando precedente elimina tutti i numeri gratuiti di accesso alle conferenze telefoniche con accesso esterno, in questo esempio tutti i numeri con LineUri che inizia con "tel:+1800". A tale scopo, nel comando viene utilizzato Get-CsDialInConferencingAccessNumber insieme al parametro Filter per restituire una raccolta di tutti numeri di accesso gratuiti configurati per l'utilizzo nell'organizzazione. Il valore di filtro {LineUri -like "tel:+1800*"} circoscrive i dati restituiti ai numeri con proprietà LineUri che inizia con il valore stringa "tel:+1800". La raccolta filtrata viene quindi inviata tramite pipe a Remove-CsDialInConferencingAccessNumber, che elimina tutti i numeri della raccolta.

-------------------------- Esempio 3 ------------------------

Get-CsDialInConferencingAccessNumber -Region "Redmond" | Remove-CsDialInConferencingAccessNumber

Nell'esempio 3 vengono eliminati tutti i numeri di accesso per le conferenze telefoniche con accesso esterno dell'area Redmond. Per eseguire questa attività, vengono chiamati innanzitutto Get-CsDialInConferencingAccessNumber e il parametro Region per restituire una raccolta di tutti i numeri di accesso dell'area Redmond. Ovvero, tutti i numeri di accesso che includono Redmond nel rispettivo elenco dei paesi. La raccolta viene quindi inviata tramite pipe a Remove-CsDialInConferencingAccessNumber, che elimina tutti i numeri di accesso della raccolta.

-------------------------- Esempio 4 ------------------------

Get-CsDialInConferencingAccessNumber -Region $Null | Remove-CsDialInConferencingAccessNumber

Nell'esempio 4 vengono eliminati tutti i numeri di accesso per le conferenze telefoniche con accesso esterno non associati a un'area. A tale scopo, viene chiamato Get-CsDialInConferencingAccessNumber insieme al parametro Region e al valore di parametro $Null. In questo modo viene restituita una raccolta di numeri di accesso con proprietà Region vuota. La raccolta viene quindi inviata tramite pipe a Remove-CsDialInConferencingAccessNumber, che elimina tutti i numeri della raccolta.

-------------------------- Esempio 5 ------------------------

Get-CsDialInConferencingAccessNumber | Where-Object {$_.PrimaryLanguage -ne "it-IT"} | Remove-CsDialInConferencingAccessNumber

Il comando mostrato nell'esempio 5 consente di eliminare tutti i numeri di accesso per le conferenze telefoniche con accesso esterno in cui la lingua principale non è impostata su Italiano. A tale scopo, viene innanzitutto chiamato Get-CsDialInConferencingAccessNumber senza alcun parametro per restituire una raccolta di tutti i numeri di accesso alle conferenze telefoniche con accesso esterno configurati per l'utilizzo nell'organizzazione. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che seleziona tutti i numeri con proprietà PrimaryLanguage diversa da "it-IT" (italiano). La raccolta filtrata viene quindi inviata tramite pipe a Remove-CsDialInConferencingAccessNumber, che elimina tutti i numeri di accesso della raccolta.

-------------------------- Esempio 6 ------------------------

Get-CsDialInConferencingAccessNumber -Filter {DisplayName -eq "Default Dial-In Access Number"} | Remove-CsDialInConferencingAccessNumber

Nell'esempio 6 viene eliminato il numero di accesso alle conferenze telefoniche con accesso esterno con nome visualizzato "Default Dial-In Access Number". Per eseguire questa attività, viene chiamato Get-CsDialInConferencingAccessNumber insieme al parametro Filter e al valore di filtro {DisplayName -eq "Default Dial-In Access Number"}. Il valore di filtro limita i dati restituiti al numero di accesso con proprietà DisplayName uguale a "Default Dial-In Access Number". L'oggetto restituito viene quindi inviato tramite pipe a Remove-CsDialInConferencingAccessNumber, che elimina il numero di accesso corrispondente.