Get-CsUser
Ultima modifica dell'argomento: 2012-03-23
Restituisce le informazioni su tutti gli utenti nell'organizzazione abilitati per Microsoft Lync Server 2010 o una versione precedente del software (ad esempio, Microsoft Office Communications Server 2007 R2).
Sintassi
Get-CsUser [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-LdapFilter <String>] [-OnLyncServer <SwitchParameter>] [-OnOfficeCommunicationServer <SwitchParameter>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>] [-UnAssignedUser <SwitchParameter>]
Descrizione dettagliata
Utilizzati insieme, i cmdlet Get-CsAdUser e Get-CsUser consentono di ottenere informazioni dettagliate su tutti gli account utente di Active Directory. Get-CsAdUser restituisce informazioni su tutti gli account utente, compresi gli utenti abilitati per Lync Server 2010 o Office Communications Server e gli utenti non abilitati per Lync Server o Office Communications Server. A differenza di Get-CsUser, che restituisce informazioni solo sugli utenti i cui account sono stati abilitati per Lync Server o Office Communications Server.
Sebbene esista una certa sovrapposizione tra Get-CsUser e Get-CsAdUser i due cmdlet differiscono nel tipo di informazioni restituite. Di solito, Get-CsUser restituisce valori per gli attributi di Active Directory correlati a Lync Server. Ad esempio, Get-CsUser restituisce i criteri di Lync Server assegnati ad un utente; l'URI di linea, l'URI assegnato a quell'utente e i dettagli relativi al fatto che l'utente sia stato abilitato o meno per VoIP aziendale. Questi attributi non faranno parte di un account utente se tale utente non è stato abilitato per Lync Server.
Al contrario, Get-CsAdUser restituisce valori generici per gli attributi di Active Directory: attributi che fanno parte dell'account utente di Active Directory di base e che sono presenti anche se l'utente non è stato abilitato per Lync Server. Ad esempio, il cmdlet Get-CsAdUser restituisce informazioni sull'utente, quali il reparto e l'organizzazione per cui lavora, la qualifica, il numero di telefono e l'indirizzo dell'ufficio.
Per visualizzare un elenco completo dei valori di attributo restituiti da Get-CsUser, digitare il comando seguente nel prompt dei comandi di Windows PowerShell:
Get-CsUser | Get-Member.
Get-CsUser consente di filtrare in diversi modi la raccolta di utenti restituita dal cmdlet. Ad esempio, se non si desidera ottenere tutti gli account utente di Lync Server, è possibile applicare il parametro facoltativo Filter o LDAPFilter. Questi parametri si escludono reciprocamente: se si utilizza Filter in un comando, non è possibile utilizzare LDAPFilter nello stesso comando (e viceversa). Il parametro Filter restituisce solo i dati relativi agli utenti che soddisfano i criteri di Lync Server specificati; ad esempio, possono essere restituiti solo i dati degli utenti i cui account si trovano sul pool di registrazione specificato o solo i dati degli utenti abilitati per VoIP aziendale. Il parametro LDAPFilter consente di limitare i dati restituiti per gli utenti che soddisfano altri criteri basati su Active Directory, ad esempio gli utenti che lavorano in una provincia o in uno stato specifico, gli utenti che possiedono o meno un cercapersone oppure gli utenti con un titolo professionale specificato.
Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsUser può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. 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 "Get-CsUser\b"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
Parametro User ID |
Indica l'identità dell'account utente da recuperare. Le identità dell'utente possono essere specificate utilizzando uno dei seguenti quattro formati: 1) l'indirizzo SIP dell'utente; 2) il nome dell'entità utente (UPN); 3) il nome del dominio e il nome di accesso dell'utente nella forma dominio\accesso (ad esempio, litwareinc\davidegarghentini); 4) il nome visualizzato Active Directory dell'utente (ad esempio, Davide Garghentini). È anche possibile fare riferimento a un account utente utilizzando il nome distinto Active Directory dell'utente. È possibile utilizzare il carattere jolly asterisco (*) quando si utilizza il nome visualizzato come identità (Identity) utente. Ad esempio, il parametro Identity "* Smith" restituirà tutti gli utenti con un nome visualizzato che termina con " Smith". |
Credential |
Facoltativo |
Oggetto PSCredential |
Consente di eseguire il cmdlet Get-CsUser utilizzando credenziali alternative. Può essere obbligatorio se l'account utilizzato per accedere a Windows non dispone dei privilegi necessari, richiesti per utilizzare gli oggetti utente. Per utilizzare il parametro Credential è necessario creare per prima cosa un oggetto PSCredential utilizzando il cmdlet Get-Credential. Per informazioni dettagliate, vedere nella Guida l'argomento contenente le informazioni sul cmdlet Get-Credential. |
DomainController |
Facoltativo |
Stringa |
Consente di eseguire la connessione al controller di dominio specificato per recuperare le informazioni sull'utente. Per la connessione a un controller di dominio specifico, includere il parametro DomainController seguito dal nome di dominio completo (ad esempio, atl-cs-001.litwareinc.com). |
Filter |
Facoltativo |
Stringa |
Consente di limitare i dati restituiti applicando un filtro in base ad attributi specifici di Lync Server. Ad esempio, è possibile limitare i dati restituiti agli utenti a cui è stato assegnato un criterio vocale specifico o agli utenti a cui non è stato assegnato un criterio vocale specifico. Il parametro Filter utilizza la stessa sintassi di filtro Windows PowerShell impiegata dal cmdlet Where-Object. Ad esempio, un filtro che restituisce solo utenti abilitati per VoIP aziendale sarà simile a quello seguente, dove EnterpriseVoiceEnabled indica l'attributo di Servizi di dominio Active Directory, -eq indica l'operatore di confronto (uguale a) e $True (una variabile incorporata di Windows PowerShell) indica il valore del filtro: {EnterpriseVoiceEnabled -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). Ad esempio, è possibile limitare i dati restituiti agli utenti che lavorano in un reparto specifico o agli utenti che possiedono una qualifica specifica. Il parametro LDAPFilter utilizza il linguaggio di query LDAP per la creazione dei filtri. Ad esempio, un filtro che restituisce solo gli utenti che lavorano a Redmond sarà simile al seguente: "l=Redmond", dove "l" (elle minuscola) rappresenta l'attributo di Active Directory (località), "=" rappresenta l'operatore di confronto (uguale a) e "Redmond" rappresenta il valore di filtro. |
OnOfficeCommunicationServer |
Facoltativo |
Parametro opzionale |
Restituisce una raccolta di utenti ospitata su una versione precedente di Lync Server (ad esempio, Office Communications Server 2007 R2). Gli utenti i cui account sono associati alla versione corrente del software non verranno restituiti quando si utilizza questo parametro. |
OnLyncServer |
Facoltativo |
Parametro opzionale |
Restituisce una raccolta di utenti ospitati su Lync Server 2010. Gli utenti i cui account sono associati alle versioni precedenti del software non verranno restituiti quando si utilizza questo parametro. |
OU |
Facoltativo |
Nome distinto |
Consente di ottenere solo gli account utente di una specifica unità organizzativa o di un contenitore. Il parametro OU restituisce 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 restituiti gli utenti di tutte e tre le unità organizzative. Per specificare una OU occorre utilizzare il nome distinto (DN) del contenitore, ad esempio: -OU "OU=Finance,dc=litwareinc,dc=com". Per restituire account utente da un contenitore Users, utilizzare la seguente sintassi: -OU "cn=Users,dc=litwareinc,dc=com". |
ResultSize |
Facoltativo |
Numero intero |
Consente di limitare il numero di record restituiti dal cmdlet. Ad esempio, per restituire sette utenti (indipendentemente dal numero di utenti nella foresta), includere il parametro -ResultSize e impostarne il valore su 7. Non c'è modo di stabilire quali sette utenti saranno restituiti. ResultSize può essere impostato su qualsiasi numero intero compreso tra 0 e 2147483647. Se impostato su 0, il comando verrà eseguito ma i dati non verranno restituiti. Se si imposta ResultSize su 7, ma la foresta contiene solo tre utenti, il comando restituirà i tre utenti e verrà completato senza errori. |
UnassignedUser |
Facoltativo |
Parametro opzionale |
Consente di ottenere una raccolta di tutti gli utenti abilitati per Lync Server ma non assegnati al momento ad un pool di registrazione. Agli utenti non è consentito accedere a Lync Server a meno che non vengano assegnati ad un pool di registrazione. |
Tipi di input
Stringa. Get-CsUser accetta un valore stringa da pipeline che rappresenta l'identità di un account utente abilitato per Lync Server 2010.
Tipi restituiti
Get-CsUser restituisce le istanze dell'oggetto Microsoft.Rtc.Management.ADConnect.Schema.ADUser.
Esempio
-------------------------- Esempio 1 --------------------------
Get-CsUser
Nell'esempio precedente viene utilizzato Get-CsUser senza parametri per ottenere una raccolta di tutti gli utenti del dominio abilitati per Lync Server o Office Communications Server.
-------------------------- Esempio 2 --------------------------
Get-CsUser | Format-Table -Property DisplayName, SipAddress, EnterpriseVoiceEnabled -AutoSize
Nell'Esempio 2 Get-CsUser viene utilizzato per ottenere una raccolta di tutti gli utenti del dominio abilitati per Lync Server o Office Communications Server. Per impostazione predefinita, Get-CsUser restituisce numerose proprietà e valori di proprietà, molti dei quali non saranno utili in una determinata situazione. Quindi, in questo esempio, i dati recuperati vengono inviati tramite pipe al cmdlet Format-Table. Format-Table utilizza, quindi, il parametro Property per selezionare le proprietà DisplayName, SipAddress, CSEnabled e EnterpriseVoiceEnabled e visualizzarle insieme ai relativi valori in una tabella.
-------------------------- Esempio 3 --------------------------
Get-CsUser -Identity "Pilar Ackerman"
Nell'Esempio 3, il parametro Identity viene utilizzato per ottenere solo l'account utente con l'identità (in questo caso, DisplayName) Luisa Cazzaniga.
-------------------------- Esempio 4 --------------------------
Get-CsUser -Identity "Pilar*"
Nell'Esempio 4 viene utilizzato il carattere jolly asterisco (*) quando si specifica l'identità utente. In questo caso, Get-CsUser restituisce tutti gli utenti la cui identità inizia con "Pilar".
-------------------------- Esempio 5 --------------------------
Get-CsUser -Filter {VoicePolicy -eq $Null}
Il comando riportato nell'Esempio 5 restituisce una raccolta di utenti a cui non è assegnato un criterio vocale. Per ottenere questo risultato, il comando utilizza il parametro Filter seguito dal filtro VoicePolicy -eq "$Null. Quando si creano i filtri da utilizzare con Get-CsUser, è necessario specificare il nome della proprietà (VoicePolicy) seguito dall'operatore di confronto (in questo caso, "eq", che indica "uguale a"). Subito dopo l'operatore di confronto deve comparire il valore per cui si esegue la verifica. In questo esempio quel valore è $Null, una variabile di Windows PowerShell che rappresenta un valore nullo.
Per restituire una raccolta di utenti ai quali è assegnato un criterio vocale, utilizzare questo comando:
Get-CsUser -Filter {VoicePolicy -ne $Null}
-------------------------- Esempio 6 --------------------------
Get-CsUser -LDAPFilter "Department=Finance"
Il comando precedente utilizza il parametro LDAPFilter per ottenere solo i dati relativi agli utenti che lavorano nel reparto Finance. Questo risultato viene ottenuto utilizzando il filtro LDAP con valore "Department=Finance".
-------------------------- Esempio 7 --------------------------
Get-CsUser -LDAPFilter "&(Department=Finance)(Title=Manager)"
Nell'Esempio 7 viene illustrato l'utilizzo di una query AND insieme al parametro LDAPFilter. Questa query (che utilizza il carattere "&" per indicare una query AND) indica due condizioni: "Department=Finance" e "Title=Manager". Per fare in modo che questa query restituisca un account utente, entrambe le condizioni devono essere True: l'utente deve lavorare nel reparto Finance e deve possedere la qualifica Manager.
-------------------------- Esempio 8 --------------------------
Get-CsUser -LdapFilter "|(Title=Supervisor)(Title=Manager)"
Nel comando riportato nell'Esempio 8, viene utilizzata una query OR (indicata dal simbolo "|") con il parametro LDAPFilter. Nella query AND riportata nell'Esempio 7, entrambe le condizioni dovevano essere True per fare in modo che un account utente fosse restituito. Con una query OR deve essere True solo una condizione per fare in modo che l'account venga restituito. In questo caso, l'account utente verrà restituito se l'utente possiede la qualifica Supervisor o Manager.
-------------------------- Esempio 9 --------------------------
Get-CsUser -OU "ou=Finance,ou=North America,dc=litwareinc,dc=com"
Nell'Esempio 9 vengono restituite le informazioni sull'account di tutti gli utenti nell'unità organizzativa Finance.
-------------------------- Esempio 10 --------------------------
Get-CsUser -UnassignedUser
Il comando precedente restituisce una raccolta di tutti gli utenti abilitati per Lync Server o Office Communications Server ma non assegnati al momento ad un pool di registrazione.