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.
Vedere anche
Ulteriori risorse
Get-CsAnalogDevice
Move-CsAnalogDevice
New-CsAnalogDevice
Remove-CsAnalogDevice