Condividi tramite

  • Articolo

Get-CsCommonAreaPhone

 

Ultima modifica dell'argomento: 2012-03-23

Restituisce informazioni sui telefoni delle aree comuni gestiti tramite Microsoft Lync Server 2010. I telefoni delle aree comuni sono telefoni situati nella sale di attesa degli edifici, nelle sale di ritrovo del personale o in altre aree in cui è probabile che vengano utilizzati da persone diverse e con finalità diverse.

Sintassi

Get-CsCommonAreaPhone [-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 telefoni delle aree comuni sono telefoni IP non associati a un singolo utente. Anziché essere posizionati in un ufficio, i telefoni delle aree comuni si trovano in genere nelle sale di attesa degli edifici, nelle mense, nelle sale di ritrovo del personale, nelle sale riunioni e in altri luoghi in cui è probabile che si riuniscano numerose persone. Questo scenario rappresenta per gli amministratori una sfida per la gestione. L'utilizzo dei telefoni in Lync Server 2010 infatti viene gestito in genere utilizzando criteri vocali e dial plan che vengono assegnati a singoli utenti. I telefoni delle aree comuni invece non sono assegnati a singoli utenti.

La soluzione consiste nel creare oggetti contatto di Active Directory per tutti i telefoni delle aree comuni. Gli oggetti contatto possono essere creati tramite il cmdlet New-CsCommonAreaPhone. Analogamente agli account utente, è possibile assegnare criteri e piani vocali agli oggetti contatto. Di conseguenza, sarà possibile mantenere il controllo sui telefoni delle aree comuni anche se i telefoni non sono associati a un singolo utente. Per impedire ad esempio alle persone di trasferire o parcheggiare le chiamate da un telefono delle aree comuni, è possibile creare un criterio vocale che impedisca il trasferimento e il parcheggio delle chiamate e quindi assegnarlo al telefono delle aree comuni. Oppure, in modo più corretto, all'oggetto contatto che rappresenta il telefono dell'area comune. Ad esempio, con il comando seguente è possibile assegnare il criterio vocale CommonAreaPhoneVoicePolicy a tutti i telefoni delle aree comuni:

Get-CsCommonAreaPhone | Grant-CsVoicePolicy –PolicyName "CommonAreaPhoneVoicePolicy"

Get-CsCommonAreaPhone consente di recuperare informazioni sui telefoni delle aree comuni configurati per l'utilizzo all'interno dell'organizzazione. Se si chiama Get-CsCommonAreaPhone senza alcun parametro, il cmdlet restituirà informazioni su tutti i telefoni delle aree comuni. I parametri facoltativi mettono a disposizione diversi metodi per filtrare le informazioni. È ad esempio possibile restituire tutti i telefoni delle aree comuni contenenti oggetti contatto in una specifica unità organizzativa (OU) o tutti gli oggetti contatto presenti in un determinato edificio.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsCommonAreaPhone i membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. 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 "Get-CsCommonAreaPhone"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Parametro ID utente

Identificatore univoco per il telefono dell'area comune. I telefoni delle aree comuni vengono identificati tramite il nome distinto (DN) Active Directory dell'oggetto contatto associato. Per impostazione predefinita, questi telefoni delle aree comuni utilizzano un identificatore univoco globale (GUID) come nome comune e pertanto presentano in genere 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-CsCommonAreaPhone utilizzando credenziali alternative. Può essere necessario se l'account utilizzato per accedere a Windows non dispone dei privilegi necessari richiesti per utilizzare gli oggetti contatto.

Per utilizzare il parametro Credential, è necessario creare innanzitutto un oggetto PSCredential utilizzando il cmdlet Get-Credential. Per informazioni dettagliate, vedere l'argomento della Guida relativo al cmdlet 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 specifico, includere il parametro DomainController seguito dal nome di dominio completo (FQDN) del computer, ad esempio atl-cs-001.litwareinc.com.

Filter

Facoltativo

Stringa

Consente di limitare i dati restituiti applicando un filtro basato su attributi specifici di Lync Server 2010. Ad esempio, è possibile limitare i dati restituiti agli oggetti contatto del telefono per aree comuni 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 su cu si basa il cmdlet Where-Object.

LdapFilter

Facoltativo

Stringa

Consente di limitare i dati restituiti applicando un filtro basato su 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 solo gli oggetti contatto che rappresentano i telefoni delle aree comuni della città di Redmond potrebbe essere analogo al seguente:

-LDAPFilter "l=Redmond"

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

OU

Facoltativo

Nome distinto di Active Directory

Consente di restituire gli oggetti contatto di una specifica unità organizzativa di Active Directory. Il parametro OU restituisce i dati dell'unità organizzativa specificata e delle relative unità organizzative figlio. Se ad esempio l'unità organizzativa Finance contiene due unità organizzative figlio, AccountsPayable e AccountsReceivable, verranno restituite le informazioni relative ai telefoni delle aree comuni di ciascuna unità organizzativa.

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. Per restituire ad esempio sette telefoni delle aree comuni (indipendentemente dal numero di telefoni delle aree comuni presenti nella foresta), includere il parametro ResultSize e impostarne il valore su 7. Non esiste alcun modo per stabilire quali telefoni saranno scelti tra i sette restituiti. Se si imposta il parametro ResultSize su 7, ma la foresta in uso contiene solo tre telefoni delle aree comuni, il comando restituirà i tre telefoni e terminerà 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-CsCommonAreaPhone accetta un valore stringa da pipeline che rappresenta l'identità del telefono delle aree comuni.

Tipi restituiti

Get-CsCommonAreaPhone restituisce le istanze dell'oggetto Microsoft.Rtc.Management.ADConnect.Schema.OCSADCommonAreaPhoneContact.

Esempio

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

Get-CsCommonAreaPhone

Il comando mostrato nell'esempio 1 restituisce le informazioni su tutti i telefoni delle aree comuni configurati per l'utilizzo all'interno dell'organizzazione. È possibile eseguire questa operazione chiamando Get-CsCommonAreaPhone senza alcun parametro.

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

Get-CsCommonAreaPhone -Filter {DisplayName -eq "Building 14 Lobby"}

Nell'esempio 2 viene restituito il telefono delle aree comuni con nome visualizzato Active Directory "Building 14 Lobby". Questa attività viene eseguita mediante includendo il parametro Filter e il valore di filtro {DisplayName -eq "Building 14 Lobby"}. Il valore di filtro limita gli oggetti restituiti ai telefoni delle aree comuni con proprietà DisplayName uguale a "Building 14 Lobby".

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

Get-CsCommonAreaPhone  -Filter {DisplayName -like "Building 14*"}

Il comando precedente restituisce tutti i telefoni delle aree comuni con un nome visualizzato di Active Directory che inizia con i caratteri "Building 14". A tale scopo, viene chiamato Get-CsCommonAreaPhone insieme al parametro Filter e al valore di filtro {DisplayName -like "Building 14*"}. Il valore di filtro utilizza l'operatore -like e la stringa con carattere jolly "Building 14*" per limitare i dati restituiti ai telefoni con proprietà DisplayName che inizia per "Building 14", ad esempio "Building 14 Lobby", "Building 14 Cafeteria" e così via.

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

Get-CsCommonAreaPhone  -Filter {LineUri -eq "tel:+14255551234"}

Nell'esempio 4, viene restituito un telefono singolo dell'area comune: il telefono con proprietà LineUri uguale a "tel:+14255551234". Poiché le proprietà LineUri devono essere univoche, questo comando non restituisce mai più di un elemento.

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

Get-CsCommonAreaPhone -Filter {DialPlan -eq $Null}

Il comando riportato nell'esempio 5 restituisce le informazioni su tutti i telefoni delle aree comuni a cui non è stato assegnato un dial plan. È possibile eseguire questa operazione utilizzando il parametro Filter e il valore di filtro {DialPlan -eq $Null}, in modo da limitare i dati restituiti ai telefoni con proprietà DialPlan uguale a un valore Null. Se a un telefono delle aree comuni non è stato esplicitamente assegnato un dial plan, il telefono utilizzerà automaticamente il dial plan globale o, se disponibile, il dial plan assegnato al sito.

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

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

Il comando precedente restituisce una raccolta di tutti i telefoni delle aree comuni che dispongono di un oggetto contatto nell'unità organizzativa Telecommunications in Servizi di dominio Active Directory. A tale scopo, viene chiamato Get-CsCommonAreaPhone insieme al parametro OU. Il valore del parametro limita gli oggetti restituiti ai telefoni con oggetti contatto nell'unità organizzativa con nome distinto ou=Telecommunications,dc=litwareinc,dc=com.