Condividi tramite

  • Articolo

Remove-CsAnalogDevice

 

Ultima modifica dell'argomento: 2012-03-27

Rimuove un dispositivo esistente dalla raccolta di dispositivi analogici che possono essere gestiti tramite Microsoft Lync Server 2010. Un dispositivo analogico è un telefono o un altro dispositivo connesso alla rete PSTN (Public Switched Telephone Network).

Sintassi

Remove-CsAnalogDevice [-Identity] <UserIdParameter> [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>] [-WhatIf] [-Confirm]

Descrizione dettagliata

Tra i dispositivi analogici sono inclusi telefoni, fax, modem e dispositivi TTY/TTD (Teletype/Telecommunication Device for the Deaf) connessi alla rete PSTN (Public Switched Telephone Network). Contrariamente ai dispositivi basati su VoIP aziendale, ovvero la soluzione VoIP (Voice over Internet Protocol) offerta da Microsoft, i dispositivi analogici non trasmettono informazioni utilizzando pacchetti digitali. Le informazioni vengono invece trasmesse tramite un segnale continuo. Questo segnale viene comunemente definito segnale analogico e da qui deriva il termine "dispositivi analogici".

Affinché gli amministratori possano gestire i dispositivi analogici per le organizzazioni, Lync Server 2010 consente di associare i dispositivi analogici agli oggetti contatto di Active Directory. Una volta associato un dispositivo a un oggetto contatto, è possibile gestire il dispositivo analogico assegnando criteri e dial plan al contatto.

Nel corso del tempo, è possibile che si desideri eliminare un contatto associato a un dispositivo analogico. Se ad esempio si eliminano gradualmente tutti i fax, non sarà più necessario disporre dei dispositivi analogici e degli oggetti contatto associati a tali apparecchi. Il cmdlet Remove-CsAnalogDevice consente di eliminare i dispositivi analogici. Una volta eseguito questo cmdlet, il dispositivo viene eliminato dall'elenco dei dispositivi analogici restituiti da Get-CsAnalogDevice. Verrà eliminato da Servizi di dominio Active Directory anche l'oggetto contatto associato al dispositivo in questione.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Remove-CsAnalogDevice i membri dei seguenti gruppi: RTCUniversalUserAdmins. Le autorizzazioni per l'esecuzione di questo cmdlet per siti oppure unità organizzative di Active Directory specifiche possono essere assegnate tramite il cmdlet Grant-CsOUPermission. 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-CsAnalogDevice"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Nome distinto di Active Directory

Identificatore univoco per il dispositivo analogico da rimuovere. I dispositivi analogici vengono identificati utilizzando il nome distinto (DN) Active Directory dell'oggetto contatto associato. Per impostazione predefinita, questi dispositivi utilizzano un identificatore univoco globale (GUID) come nome comune e pertanto presentano in genere una proprietà Identity simile alla seguente: CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com. Per questo motivo, è possibile che risulti più semplice recuperare i dispositivi analogici tramite il cmdlet Get-CsAnalogDevice e quindi inviare tramite pipe a Remove-CsAnalogDevice gli oggetti restituiti.

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.OCSADAnalogDeviceContact. Remove-CsAnalogDevice accetta le istanze da pipeline dell'oggetto dispositivo analogico.

Tipi restituiti

Remove-CsAnalogDevice elimina le istanze esistenti dell'oggetto Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact.

Esempio

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

Remove-CsAnalogDevice -Identity "CN={e5e7daba-394e-46ec-95a1-1f2a9947aad2},CN=Users,DC=litwareinc,DC=com"

Nell'esempio 1 viene eliminato il dispositivo analogico con Identity CN={e5e7daba-394e-46ec-95a1-1f2a9947aad2},CN=Users,DC=litwareinc,DC=com.

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

Get-CsAnalogDevice -Filter {DisplayName -eq "Building 14 Receptionist"} | Remove-CsAnalogDevice

Il comando mostrato nell'esempio 2 elimina tutti i dispositivi analogici a cui è stato assegnato il nome visualizzato "Building 14 Receptionist". Per eseguire questa attività, il comando chiama innanzitutto Get-CsAnalogDevice e il parametro Filter. Il valore di filtro {DisplayName -eq "Building 14 Receptionist"} limita gli oggetti restituiti ai dispositivi analogici con proprietà DisplayName uguale a "Building 14 Receptionist". Gli elementi restituiti vengono quindi inviati tramite pipe a Remove-CsAnalogDevice, che li rimuove.

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

Get-CsAnalogDevice -Filter {VoicePolicy -eq "RedmondVoicePolicy"} | Remove-CsAnalogDevice

Il comando precedente elimina tutti i dispositivi analogici a cui è stato assegnato il criterio vocale RedmondVoicePolicy. A tale scopo, vengono utilizzati Get-CsAnalogDevice e il parametro Filter per recuperare tutti i dispositivi analogici con proprietà VoicePolicy uguale a RedmondVoicePolicy. La raccolta filtrata viene quindi inviata tramite pipe al cmdlet Remove-CsAnalogDevice, che elimina tutti gli elementi della raccolta.

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

Get-CsAnalogDevice -Filter {AnalogFax -eq $True} | Remove-CsAnalogDevice

Il comando mostrato nell'esempio 4 rimuove tutti i fax analogici attualmente in uso nell'organizzazione. Per eseguire questa attività, viene innanzitutto chiamato Get-CsAnalogDevice insieme al parametro Filter. Il valore di filtro {AnalogFax –eq $True} seleziona solo i dispositivi con proprietà AnalogFax uguale a True. La raccolta filtrata viene a sua volta inviata tramite pipe a Remove-CsAnalogDevice, che rimuove tutti gli elementi al suo interno.