Condividi tramite

  • Articolo

Set-CsAnalogDevice

 

Ultima modifica dell'argomento: 2012-03-26

Consente di modificare un dispositivo presente nella raccolta di dispositivi analogici che può essere gestita tramite Microsoft Lync Server 2010. Un dispositivo analogico è un telefono o altro dispositivo connesso alla rete telefonica PSTN (Public Switched Telephone Network).

Sintassi

Set-CsAnalogDevice -Identity <UserIdParameter> [-AnalogFax <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-Gateway <Fqdn>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

I dispositivi analogici includono telefoni, apparecchi fax, modem e dispositivi TTY/TTD (Teletype/Telecommunication Devices for the Deaf) connessi alla rete PSTN (Public Switched Telephone Network). A differenza dei dispositivi che traggono vantaggio da VoIP aziendale, la soluzione VoIP offerta da Microsoft, i dispositivi analogici non trasmettono informazioni utilizzando pacchetti digitali. Le informazioni, invece, vengono trasmesse utilizzando un segnale continuo. Questo segnale viene comunemente denominato segnale analogico; da qui l'espressione "dispositivi analogici".

Per consentire agli amministratori di gestire i dispositivi analogici, 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.

Il cmdlet Set-CsAnalogDevice consente di modificare le proprietà degli oggetti contatto associati ai dispositivi analogici. Ad esempio, è possibile cambiare il nome visualizzato del contatto di Active Directory e anche l'URI linea associato al dispositivo.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Set-CsAnalogDevice può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalUserAdmins. Il permesso di eseguire questo cmdlet per siti specifici o specifiche unità organizzative di Active Directory (OU) può essere assegnato utilizzando il cmdlet Grant-CsOUPermission. 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 "Set-CsAnalogDevice"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Parametro ID utente

Identificatore univoco per il dispositivo analogico che viene modificato. I dispositivi analogici vengono identificati utilizzando il nome distinto Active Directory (DN) dell'oggetto contatto associato. Per impostazione predefinita, i dispositivi analogici utilizzano un GUID (identificatore univoco globale) come nome comune e ciò significa che in genere l'identità dei dispositivi è simile alla seguente: CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com. Per questo motivo, potrebbe risultare più semplice modificare i dispositivi analogici utilizzando il cmdlet Get-CsAnalogDevice per restituire gli oggetti dispositivi analogici e quindi inviando tramite pipe tali oggetti a Set-CsAnalogDevice.

Gateway

Facoltativo

Stringa

Indirizzo IP del gateway PSTN utilizzato dal dispositivo analogico.

AnalogFax

Facoltativo

Booleano

Impostare su True ($True) se il dispositivo analogico è un apparecchio fax. Impostare su False($False) se il dispositivo analogico non è un apparecchio fax.

LineURI

Facoltativo

Stringa

Numero di telefono del dispositivo analogico. L'URI di linea deve essere specificato utilizzando il formato E.164 e il prefisso "TEL:". Ad esempio: TEL:+14255551297. Qualsiasi numero di interno deve essere aggiunto alla fine dell'URI di linea, ad esempio: TEL:+14255551297;ext=51297.

SipAddress

Facoltativo

Indirizzo SIP

Un identificatore univoco che consente al dispositivo analogico di comunicare con i dispositivi SIP, ad esempio Microsoft Lync 2010. L'indirizzo SIP deve essere preceduto dal prefisso "sip:". Ad esempio: sip:bldg14lobby@litwareinc.com.

DisplayName

Facoltativo

Stringa

Consente di configurare il nome visualizzato in Active Directory del dispositivo analogico.

DisplayNumber

Facoltativo

Stringa

Numero telefonico come viene visualizzato in Lync 2010. La proprietà DisplayNumber può essere formattata in qualsiasi modo; ad esempio, 1-800-555-1234, 1-(800)-555-1234, 1.800.555.1234 e così via.

DomainController

Facoltativo

Parametro opzionale

Consente la connessione al controller di dominio specificato per modificare le informazioni sul contatto. Per la connessione a uno specifico controller di dominio, includere il parametro -DomainController seguito dal nome computer (ad esempio atl-mcs-001) o dal suo nome di dominio completo (FQDN) (ad esempio atl-mcs-001.litwareinc.com).

Enabled

Facoltativo

True

Quando il valore è True ($True), il dispositivo analogico può essere utilizzato con Lync Server 2010.

EnterpriseVoiceEnabled

Facoltativo

Booleano

Indica se l'oggetto contatto per il dispositivo analogico è stato abilitato per VoIP aziendale, la soluzione VoIP offerta da Microsoft. Con VoIP aziendale, è possibile effettuare chiamate via Internet anziché utilizzare la rete telefonica standard.

PassThru

Facoltativo

Parametro opzionale

Restituisce un oggetto che rappresenta il telefono nell'area comune.

WhatIf

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. Set-CsAnalogDevice accetta istanze dell'oggetto dispositivo analogico tramite pipeline.

Tipi restituiti

Per impostazione predefinita il cmdlet Set-CsAnalogDevice non restituisce oggetti o valori. Tuttavia, se si include il parametro PassThru, il cmdlet restituirà le istanze dell'oggetto Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact.

Esempio

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

Set-CsAnalogDevice -Identity "CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com" -LineUri "TEL:+14255551298"

Il comando precedente modifica il valore della proprietà LineUri del dispositivo analogico la cui identità è CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com.

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

Get-CsAnalogDevice -Filter {Gateway -eq "192.168.0.240"} | Set-CsAnalogDevice -Gateway "192.168.1.100"

Il comando riportato nell'Esempio 2 consente di modificare il gateway di ciascun dispositivo analogico che utilizza il gateway 192.168.0.240. Per ottenere questo risultato, viene utilizzato il cmdlet Get-CsAnalogDevice con il parametro Filter; il valore del filtro {Gateway -eq "192.168.0.240"} restituisce solo i dispositivi con Gateway uguale a (-eq) 192.168.0.240. Questa raccolta filtrata viene quindi inviata tramite pipe al cmdlet Set-CsAnalogDevice che imposta la proprietà Gateway su 192.168.1.100 per ciascun elemento nella raccolta.