Get-CsAdUser
Ultima modifica dell'argomento: 2012-03-23
Consente di restituire informazioni su tutti gli account utente in Servizi di dominio Active Directory. Sono compresi gli account utente abilitati per Microsoft Lync Server 2010 e gli account non abilitati per Lync Server 2010.
Sintassi
Get-CsAdUser [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-LDAPFilter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]
Descrizione dettagliata
Get-CsAdUser consente di restituire informazioni su tutti gli account utente in Active Directory, compresi gli account utente abilitati e non abilitati per Lync Server. Il comportamento è diverso da quello di Get-CsUser, che restituisce informazioni solo per gli utenti i cui account sono stati abilitati per Lync Server o per una versione precedente del software (ad esempio Microsoft Office Communications Server 2007 R2).
Sebbene esista una certa sovrapposizione tra i due cmdlet, Get-CsAdUser e Get-CsUser differiscono a livello del tipo di informazioni restituite. Di solito, Get-CsUser restituisce valori per gli attributi di Active Directory correlati a Lync Server. Ad esempio, Get-CsUser può comunicare quali criteri di Lync Server sono stati assegnati a un utente, l'URI di linea assegnato all'utente, nonché se l'utente è stato abilitato per VoIP aziendale. Questi attributi non saranno parte di un account utente se tale utente non è stato abilitato per Lync Server.
Al contrario, Get-CsAdUser restituisce valori di attributo Active Directory generici; in pratica, restituisce informazioni sugli attributi che sono parte dell'account utente Active Directory di base e che sono presenti anche se un utente non è stato abilitato per Lync Server. Ad esempio, Get-CsAdUser restituisce informazioni sul reparto e sull'organizzazione per cui lavora l'utente, insieme al suo titolo professionale, al numero di telefono e all'indirizzo dell'ufficio. Per visualizzare un elenco completo dei valori di attributo restituiti da Get-CsAdUser, digitare il comando seguente nel prompt di Windows PowerShell:
Get-CsAdUser | Get-Member
Get-CsAdUser mette a disposizione diversi metodi per filtrare la raccolta di utenti restituita dall'esecuzione del cmdlet. Ad esempio, se non si desidera restituire tutti gli account utente Active Directory, è possibile applicare i parametri facoltativi Filter o LdapFilter. Questi parametri si escludono reciprocamente: se si utilizza Filter in un comando non è possibile utilizzare LdapFilter nello stesso (e viceversa). Il parametro Filter consente di limitare i dati restituiti agli utenti che soddisfano i criteri specificati per attributi specifici di Lync Server. Ad esempio, è possibile utilizzare il parametro Filter per restituire una raccolta degli utenti che sono stati abilitati o che non sono stati abilitati per Lync Server. Il parametro LdapFilter consente di limitare i dati restituiti per gli utenti che soddisfano altri criteri basati su attributi generici di 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.
Un aspetto importante da considerare per quando riguarda i cmdlet Get-CsAdUser è il seguente: sebbene l'attributo Enabled, che determina se un utente è stato o meno abilitato per Lync Server, sia un valore booleano, questa proprietà dispone in realtà di tre valori validi:
True. L'utente è stato abilitato per Lync Server.
False. L'account di Lync Server dell'utente è stato temporaneamente disabilitato. Questo risultato si ottiene, in genere, utilizzando il cmdlet Set-CsUser e impostando il parametro Enabled su $False.
Null. L'utente non è stato abilitato per Lync Server.
Questo significa che, se si desidera restituire un elenco di utenti non abilitati per Lync Server, è necessario utilizzare un comando che restituisca tutti gli utenti per i quali l'attributo Enabled è Null:
Get-CsAdUser –Filter {Enabled –eq $Null}
Il comando seguente restituisce invece solo gli utenti i cui account di Lync Server sono stati temporaneamente disabilitati:
Get-CsAdUser –Filter {Enabled –eq $False}
Gli utenti che non sono stati abilitati per Lync Server non verranno restituiti quando si esegue il comando precedente.
Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Get-CsAdUser in locale: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. 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-CsAdUser"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Facoltativo |
Parametro ID utente |
Indica l'identità dell'account utente da recuperare. Le identità utente possono essere specificate con uno dei quattro formati riportati di seguito: 1) l'indirizzo SIP dell'utente; 2) l'UPN (Universal Principal Name) dell'utente; 3) il nome di dominio e il nome di accesso dell'utente, nel formato dominio\accesso (ad esempio, litwareinc\davidegarghentini); 4) il nome visualizzato Active Directory dell'utente (ad esempio, Davide Garghentini). L'account utente può essere referenziati anche utilizzando il nome distinto dell'utente in Active Directory. È possibile utilizzare il carattere jolly asterisco (*) quando si utilizza il nome visualizzato come identità 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-CsAdUser 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 utente. Per utilizzare il parametro Credential è necessario creare per prima cosa un oggetto PSCredential utilizzando il cmdlet Get-Credential. 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 sull'utente. Per connettersi a un controller di dominio particolare, 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 per Lync Server. Il parametro Filter utilizza la stessa sintassi di filtro Windows PowerShell impiegata dal cmdlet Where-Object. Ad esempio, un filtro che restituisce solamente gli utenti non abilitati per Lync Server potrebbe essere simile al seguente: {Enabled -ne $True}, dove Enabled rappresenta l'attributo di Active Directory, -ne rappresenta l'operatore di confronto (diverso da) e $True (una variabile predefinita di Windows PowerShell) rappresenta il valore 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 un manager o un titolo professionale specifico. 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. |
OU |
Facoltativo |
Nome distinto |
Consente di restituire gli utenti da una specifica unità organizzativa o contenitore di Active Directory. Questo parametro 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 un'unità organizzativa occorre utilizzare il nome distinto del contenitore, ad esempio: OU=Finance,dc=litwareinc,dc=com. Per restituire gli utenti del contenitore Users, utilizzare la seguente sintassi: 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. 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. Se si imposta ResultSize su 7 ma la foresta contiene solo tre utenti, il comando restituisce tali tre utenti e viene completato senza errori. |
Tipi di input
Stringa. Get-CsAdUser accetta un valore stringa da pipeline che rappresenta l'identità di un account utente di Active Directory.
Tipi restituiti
Get-CsAdUser consente di restituire istanze dell'oggetto Microsoft.Rtc.Management.ADConnect.Schema.CSADUser.
Esempio
-------------------------- Esempio 1 --------------------------
Get-CsAdUser
Con il comando mostrato nell'esempio 1 viene restituita una raccolta di tutti gli account utente nel dominio di Active Directory.
-------------------------- Esempio 2 --------------------------
Get-CsAdUser -Identity "Pilar Ackerman"
Con l'esempio 2, Get-CsAdUser restituisce le informazioni sull'account utente di Luisa Cazzaniga. In questo esempio viene utilizzato il nome visualizzato dell'utente per specificarne l'identità.
-------------------------- Esempio 3 --------------------------
Get-CsAdUser -OU "ou=Finance,dc=litwareinc,dc=com"
Con l'esempio 3 vengono restituite le informazioni sull'account utente per tutti gli utenti nell'unità organizzativa Finance. Per eseguire questa operazione, al parametro OU deve essere passato il nome distinto dell'unità organizzativa.
-------------------------- Esempio 4 --------------------------
Get-CsAdUser -Filter {Enabled -ne $True} | Select-Object DisplayName
Con il comando precedente vengono restituiti tutti gli utenti che non sono stati abilitati per Lync Server 2010 o Office Communications Server. Per eseguire questa operazione viene utilizzato il parametro Filter insieme a Get-CsAdUser per limitare i dati restituiti agli account utente la cui proprietà Enabled non è uguale a True. Questo filtro indica a Get-CsAdUser di restituire solo gli account utente che non sono stati abilitati per l'uso con Lync Server o Office Communications Server. Dopo aver recuperato tutti i dati, le informazioni vengono inviate tramite pipe al cmdlet Select-Object, che identifica la sola proprietà (in questo caso DisplayName) che sarà effettivamente visualizzata sullo schermo.
-------------------------- Esempio 5 --------------------------
Get-CsAdUser -LdapFilter "Department=Finance"
Con l'esempio 5 viene utilizzato il parametro LdapFilter per limitare i dati restituiti agli utenti che lavorano nel reparto Finance. Questa operazione viene eseguita utilizzando il valore del filtro LDAP "Department=Finance".