Condividi tramite

  • Articolo

Get-CsAnalogDevice

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce informazioni sui dispositivi analogici che possono essere gestiti con Microsoft Lync Server 2010. Un dispositivo analogico è un telefono o un altro dispositivo collegato alla rete PSTN (Public Switched Telephone Network).

Sintassi

Get-CsAnalogDevice [-Identity] <UserIdParameter>] [-Filter <String>] [-LdapFilter <String>] [-OU <OUIdParameter>] [-DomainController <Fqdn>] [-Credential <PSCredential>] [-ResultSize <Unlimited`1>] [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>]

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 sfruttano VoIP aziendale (la soluzione VoIP offerta da Microsoft), i dispositivi analogici non trasmettono informazioni utilizzando pacchetti digitali; le informazioni vengono invece trasmesse utilizzando un segnale continuo. Questo segnale viene comunemente denominato segnale analogico; da qui l'espressione "dispositivi analogici".

Oltre ai telefoni analogici e ai telefoni che sfruttano VoIP aziendale, esiste un'altra classe di telefoni: i telefoni digitali non IP. Questi telefoni sono di proprietà del sistema PBX con cui sono stati acquistati e non possono essere gestiti utilizzando i cmdlet di Lync Server 2010.

Per consentire agli amministratori di 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.

Il cmdlet Get-CsAnalogDevice consente di recuperare le informazioni sui dispositivi analogici configurati per l'uso nell'organizzazione. Se si chiama Get-CsAnalogDevice senza parametri, il cmdlet restituisce informazioni su tutti i dispositivi analogici. I parametri opzionali mettono a disposizione diversi metodi per filtrare le informazioni; ad esempio, è possibile restituire tutti i dispositivi che dispongono di oggetti contatto in una specifica unità organizzativa o tutti i dispositivi analogici situati in un edificio specifico.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Get-CsAnalogDevice in locale: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. Le autorizzazioni per l'esecuzione di questo cmdlet in siti specifici o unità organizzative di Active Directory specifiche possono essere assegnate utilizzando il cmdlet Grant-CsOUPermission. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAnalogDevice"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Parametro ID utente

Identificatore univoco per il dispositivo analogico. I dispositivi analogici vengono identificati utilizzando il nome distinto di Active Directory dell'oggetto contatto associato. Per impostazione predefinita i dispositivi analogici utilizzano un GUID (identificatore univoco globale) come nome comune; significa che in genere i dispositivi utilizzano un'identità simile alla seguente: CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com.

Credential

Facoltativo

Oggetto credenziali PS

Consente di eseguire il cmdlet Get-CsAnalogDevice cmdlet utilizzando credenziali alternative. Può essere necessario se l'account utilizzato per accedere a Windows non dispone dei privilegi necessari richiesti per lavorare con gli oggetti contatto.

Per utilizzare il parametro Credential è necessario utilizzare il cmdlet Get-Credential per creare un oggetto PSCredential. Per informazioni dettagliate, vedere l'argomento della Guida Get-Credential.

DomainController

Facoltativo

Stringa

Consente la connessione al controller di dominio specificato per recuperare le informazioni di contatto. Per connettersi a un controller di dominio particolare, includere il parametro DomainController seguito dal nome di dominio completo del computer, ad esempio atl-cs-001.litwareinc.com.

Filter

Facoltativo

Stringa

Consente di limitare i dati restituiti applicando un filtro in base ad attributi specifici per Lync Server 2010. Ad esempio, è possibile limitare i dati restituiti agli oggetti contatto del dispositivo analogico a cui è stato assegnato uno specifico criterio vocale o ai contatti a cui tale criterio vocale specifico non è assegnato.

Il parametro Filter utilizza la stessa sintassi di filtro Windows PowerShell impiegata dal cmdlet Where-Object. Ad esempio, un filtro che restituisce solo i dispositivi fax potrebbe essere simile al seguente, in cui AnalogFax rappresenta l'attributo di Active Directory, -eq rappresenta l'operatore di confronto (uguale a) e $True (una variabile predefinita di Windows PowerShell) rappresenta il valore del filtro:

-Filter {AnalogFax -eq $True}

LdapFilter

Facoltativo

Stringa

Consente di limitare i dati restituiti applicando un filtro in base ad attributi generici di Active Directory (ovvero attributi non specifici di Lync Server 2010). Ad esempio, è possibile limitare i dati restituiti agli oggetti contatto a cui è stato assegnato uno specifico reparto o che si trovano in un determinato edificio.

Il parametro LdapFilter utilizza il linguaggio di query LDAP per la creazione dei filtri. Ad esempio, un filtro che restituisce solamente gli oggetti contatto che rappresentano dispositivi analogici nella città di Redmond potrebbe essere simile al seguente:

-LdapFilter "l=Redmond"

Nel filtro precedente, "l" rappresenta l'attributo di Active Directory (località), "=" rappresenta l'operatore di confronto (uguale a) e "Redmond" rappresenta il valore del filtro.

OU

Facoltativo

Nome distinto di Active Directory

Consente di restituire gli oggetti contatto da una specifica unità organizzativa di Active Directory. Vengono restituiti i dati dell'unità organizzativa specificata e delle unità organizzative figlio. Ad esempio, se l'unità organizzativa Finance contiene due unità organizzative figlio, AccountsPayable e AccountsReceivable, saranno restituite le informazioni sui dispositivi analogici di tutte e tre le unità organizzative.

Per specificare un'unità organizzativa occorre utilizzare il nome distinto del contenitore, ad esempio: -OU "OU=Finance,dc=litwareinc,dc=com".

ResultSize

Facoltativo

Numero intero

Consente di limitare il numero di record restituiti da un comando. Ad esempio, per restituire sette dispositivi analogici (indipendentemente dal numero di dispositivi analogici nella foresta), includere il parametro ResultSize e impostarne il valore su 7. Non c'è modo di stabilire quali sette telefoni saranno restituiti. Se si imposta ResultSize su 7 ma la foresta contiene solo tre dispositivi analogici, il comando restituisce tali tre dispositivi e viene completato senza errori.

La dimensione del risultato può essere impostata su qualsiasi numero intero compreso tra 0 e 2147483647 (compresi). Se l'impostazione è 0 il comando viene eseguito ma non restituisce dati.

Tipi di input

Stringa. Get-CsAnalogDevice accetta l'input da pipeline di un valore stringa che rappresenta l'identità del dispositivo analogico.

Tipi restituiti

Get-CsAnalogDevice restituisce istanze dell'oggetto Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact.

Esempio

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

Get-CsAnalogDevice

Con il comando mostrato nell'esempio 1 viene restituita una raccolta di tutti i dispositivi analogici attualmente configurati per l'uso nell'organizzazione. Questa operazione viene eseguita chiamando Get-CsAnalogDevice senza alcun parametro.

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

Get-CsAnalogDevice | Select-Object DisplayName, LineUri

Con l'esempio 2 vengono restituiti solo due valori di proprietà, DisplayName e LineUri, per tutti i dispositivi analogici nell'organizzazione. Per eseguire questa operazione, il comando chiama per prima cosa Get-CsAnalogDevice senza parametri per restituire tutti i valori delle proprietà per tutti i dispositivi analogici nell'organizzazione. La raccolta viene quindi inviata tramite pipe al cmdlet Select-Object, che seleziona e visualizza solo i valori per le proprietà DisplayName e LineUri.

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

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

Con l'esempio 3 vengono restituite informazioni sul dispositivo analogico con nome visualizzato di Active Directory "Building 14 Receptionist". A tal fine, il comando chiama Get-CsAnalogDevice e il parametro Filter; il valore del filtro {DisplayName -eq "Building 14 Receptionist"} limita gli oggetti restituiti ai dispositivi analogici la cui proprietà DisplayName è uguale a "Building 14 Receptionist".

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

Get-CsAnalogDevice -Filter {Gateway -eq "192.168.0.240"}

Con il comando precedente vengono restituiti tutti i dispositivi analogici configurati per il gateway 192.168.0.240. Questa operazione viene eseguita chiamando Get-CsAnalogDevice e includendo il parametro Filter; il valore del filtro "192.168.0.240" limita gli oggetti restituiti ai dispositivi analogici la cui proprietà Gateway è uguale a 192.168.0.240.

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

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

Con il comando mostrato nell'esempio 5 vengono restituite le informazioni su tutti i dispositivi fax analogici nell'organizzazione. Per eseguire questa operazione, il comando chiama per prima cosa Get-CsAnalogDevice con il parametro Filter. Il valore del filtro {AnalogFax -eq $True} limita gli oggetti restituiti agli apparecchi fax, dispositivi analogici la cui proprietà AnalogFax è uguale a True.

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

Get-CsAnalogDevice -Filter {LineUri -eq "tel:+14255556001"}

Con l'esempio 6 viene restituito un singolo dispositivo analogico: il dispositivo il cui LineUri (numero di telefono) è uguale a +14255556001.

-------------------------- Esempio 7 ------------------------

Get-CsAnalogDevice -Filter {LineUri -like "tel:+1425555*"}

Con l'esempio 7 vengono restituiti tutti i dispositivi analogici con indicativo di località 425 e prefisso telefonico 555. Per eseguire questa operazione, viene utilizzato Get-CsAnalogDevice con il parametro Filter; il valore del filtro {LineUri -like "tel:+1425555*"} consente di limitare i dati restituiti ai dispositivi la cui proprietà LineUri inizia con i caratteri "tel:+1425555". Equivale a un numero di telefono che inizia con i caratteri 1425555 (ad esempio 1-425-555-1298).

-------------------------- Esempio 8 ------------------------

Get-CsAnalogDevice -OU "ou=Telecommunications,dc=litwareinc,dc=com"

Con il comando precedente viene restituita una raccolta di tutti i dispositivi analogici che presentano un oggetto contatto nell'unità organizzativa Telecommunications di Servizi di dominio Active Directory. Per eseguire questa operazione, viene chiamato Get-CsAnalogDevice insieme al parametro OU; il valore del parametro limita gli oggetti restituiti ai dispositivi analogici che presentano oggetti contatto nell'unità organizzativa con nome distinto ou=Telecommunications,dc=litwareinc,dc=com.

-------------------------- Esempio 9 ------------------------

Get-CsAnalogDevice | Grant-CsVoicePolicy -PolicyName "AnalogVoicePolicy"

Con il comando mostrato nell'esempio 9 viene illustrato come restituire una raccolta dei dispositivi analogici e come assegnare un criterio vocale a ogni dispositivo nella raccolta. Per ottenere questo risultato, il comando utilizza prima il cmdlet Get-CsAnalogDevice senza alcun parametro per restituire una raccolta di tutti i dispositivi analogici configurati per l'utilizzo nell'organizzazione. La raccolta viene quindi inviata tramite pipe a Grant-CsVoicePolicy, che assegna il criterio vocale AnalogVoicePolicy ad ogni dispositivo nella raccolta.