New-CsAnalogDevice
Ultima modifica dell'argomento: 2012-03-23
Crea un nuovo dispositivo analogico che può essere gestito utilizzando Microsoft Lync Server 2010. Un dispositivo analogico è un telefono o un altro dispositivo connesso alla rete PSTN (Public Switched Telephone Network).
Sintassi
New-CsAnalogDevice -AnalogFax <$true | $false> -Gateway <Fqdn> -LineUri <String> -OU <OUIdParameter> -RegistrarPool <Fqdn> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]
New-CsAnalogDevice -AnalogFax <$true | $false> -DN <ADObjectId> -Gateway <Fqdn> -LineUri <String> -RegistrarPool <Fqdn> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Tra i dispositivi analogici sono inclusi i telefoni, i fax, i modem e i dispositivi TTY/TTD (Teletype/Telecommunication Devices 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 invece vengono trasmesse tramite un segnale continuo. Questo segnale viene comunemente denominato segnale analogico, da cui l'espressione "dispositivi analogici".
Affinché gli amministratori possano 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.
I nuovi dispositivi analogici vengono creati mediante il cmdlet New-CsAnalogDevice. Il cmdlet è in grado di creare nuovi oggetti contatto da utilizzare con i dispositivi analogici o di associare oggetti contatto esistenti a un nuovo dispositivo. Per informazioni dettagliate, vedere le descrizioni relative ai parametri OU e DN in questo argomento.
Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet New-CsAnalogDevice i membri dei seguenti gruppi: RTCUniversalUserAdmins. Le autorizzazioni per l'esecuzione di questo cmdlet per siti o 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 "New-CsAnalogDevice"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
LineUri |
Obbligatorio |
Stringa |
Numero di telefono del dispositivo analogico. L'URI (Uniform Resource Identifier) della linea deve essere specificato utilizzando il formato E.164 e il prefisso "TEL:", ad esempio TEL:+14255551297. L'eventuale numero di interno deve essere aggiunto alla fine dell'URI della linea, ad esempio: "TEL:+14255551297;ext=51297". |
SipAddress |
Facoltativo |
Indirizzo SIP |
Identificatore univoco (simile a un indirizzo di posta elettronica) che consente al dispositivo analogico di comunicare con dispositivi SIP come Microsoft Lync 2010. L'indirizzo SIP deve essere preceduto dal prefisso "sip:", ad esempio sip:bldg14lobby@litwareinc.com. |
RegistrarPool |
Obbligatorio |
Stringa |
Nome di dominio completo (FQDN) del pool di registrazione in cui deve essere inserito l'oggetto contatto, ad esempio -RegistrarPool "atl-cs-001.litwareinc.com". |
DisplayName |
Facoltativo |
Stringa |
Consente di configurare il nome visualizzato Active Directory del dispositivo analogico. |
DisplayNumber |
Facoltativo |
Stringa |
Numero di telefono visualizzato in Lync 2010. La proprietà DisplayNumber può essere formattata nella modalità che si preferisce, ad esempio 1-800-555-1234; 1-(800)-555-1234; 1.800.555.1234 e così via. |
AnalogFax |
Obbligatorio |
Booleano |
Impostare su True ($True) se il dispositivo analogico è un apparecchio fax. Impostare su False ($False) se il dispositivo non è un apparecchio fax. |
Gateway |
Obbligatorio |
Stringa |
Indirizzo IP del gateway PSTN che deve essere utilizzato dal dispositivo analogico. |
OU |
Obbligatorio |
Nome distinto Active Directory |
Nome distinto dell'unità organizzativa (OU) di Active Directory in cui deve essere posizionato l'oggetto contatto, ad esempio -OU "ou=Redmond,dc=litwareinc,dc=com”. Se si include il parametro OU, verrà creato un nuovo contatto nell'unità organizzativa specificata e al contatto verrà assegnato automaticamente un identificatore univoco globale (GUID) come nome comune. Di conseguenza, il nome dell'oggetto contatto sarà simile al seguente: {ce84964a-c4da-4622-ad34-c54ff3ed361f}. |
DN |
Facoltativo |
Nome distinto Active Directory |
Consente di associare un oggetto contatto di Active Directory esistente al dispositivo analogico. Se si dispone di un oggetto contatto da associare a un dispositivo analogico, utilizzare il parametro DN seguito dal nome distinto del contatto, ad esempio -DN "cn=Building 14 Lobby,dc=litwareinc,dc=com". Il comando avrà esito negativo se il contatto specificato non esiste. Non è possibile utilizzare i parametri OU e DN nello stesso comando. |
PassThru |
Facoltativo |
Parametro opzionale |
Restituisce un oggetto che rappresenta il telefono delle aree comuni. |
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
Nessuno. New-CsAnalogDevice non accetta l'input da pipeline.
Tipi restituiti
New-CsAnalogDevice crea nuove istanze dell'oggetto Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact.
Esempio
-------------------------- Esempio 1 ------------------------
New-CsAnalogDevice -LineUri tel:+14255556001 -DisplayName "Building 14 Receptionist" -RegistrarPool redmond-Cs-001.litwareinc.com -AnalogFax $False -Gateway 192.168.0.240 -OU "ou=Telecommunications,dc=litwareinc,dc=com"
Con il comando riportato nell'esempio 1 viene creato un nuovo dispositivo analogico con numero di telefono (LineUri) 1-425-555-6001. Per specificare il numero di telefono è stato utilizzato il formato E.164. Oltre al parametro LineUri, gli altri parametri utilizzati in questo comando sono DisplayName (per impostare il nome visualizzato Active Directory del dispositivo), RegistrarPool (per specificare il pool di registrazione), AnalogFax (impostato su $False per indicare che si tratta di un telefono e non di un apparecchio fax), Gateway (impostato sull'indirizzo IP del gateway) e OU (nome distinto dell'unità organizzativa di Active Directory in cui deve essere creato l'oggetto contatto del dispositivo).
Vedere anche
Ulteriori risorse
Get-CsAnalogDevice
Move-CsAnalogDevice
Remove-CsAnalogDevice
Set-CsAnalogDevice