Get-User

Articolo
08/07/2014

Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Ultima modifica dell'argomento: 2010-04-27

Il cmdlet Get-User consente di recuperare tutti gli utenti nella foresta che soddisfano le condizioni specificate.

Sintassi

get-User [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-User [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-User [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Descrizione dettagliata

Non è necessario alcun parametro. Tuttavia, è possibile utilizzare uno solo dei seguenti parametri in un comando Get-User: Identity, Filter o Anr.

Per eseguire il cmdlet Get-User, è necessario utilizzare un account che disponga della seguente delega:

Ruolo Amministratore di Exchange solo visualizzazione

Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Exchange Server 2007, vedere Considerazioni sulle autorizzazioni.

Parametri

Parametro	Obbligatorio	Tipo	Descrizione
Anr	Facoltativo	System.String	Il parametro Anr indica che l'argomento verrà risolto utilizzando la risoluzione dei nomi ambigui (ANR, Ambiguous Name Resolution).
Credential	Facoltativo	System.Management.Automation.PSCredential	Il parametro Credential specifica l'account utilizzato per leggere il servizio directory di Active Directory.
DomainController	Facoltativo	Microsoft.Exchange.Data.Fqdn	Per specificare il nome di dominio completo (FQDN) del controller di dominio che consente di recuperare i dati da Active Directory, includere nel comando il parametro DomainController.
Filter	Facoltativo	System.String	Il parametro Filter specifica un insieme di attributi che limita i destinatari restituiti dalla query. Per ulteriori informazioni sulle proprietà filtrabili, vedere Proprietà filtrabili per il parametro -Filter.
Identity	Facoltativo	Microsoft.Exchange.Configuration.Tasks.UserIdParameter	Il parametro Identity accetta uno dei seguenti valori: GUID Nome distinto (DN) Dominio\Account Nome dell'entità utente (UPN) DN legacy di Exchange Indirizzo SMTP (Simple Mail Transfer Protocol) Alias
IgnoreDefaultScope	Facoltativo	System.Management.Automation.SwitchParameter	Il parametro IgnoreDefaultScope consente al comando di ignorare l'impostazione predefinita dell'ambito dei destinatari Exchange Management Shell e di utilizzare l'intera foresta come ambito. Ciò permette al comando di accedere agli oggetti Active Directory che non si trovano nell'ambito predefinito. L'utilizzo del parametro IgnoreDefaultScope presenta le seguenti restrizioni: Non è possibile utilizzare il parametro DomainController. Il comando utilizzerà automaticamente un server di catalogo globale adeguato. È possibile utilizzare solo il nome distinto (DN) per il parametro Identity. Altre forme di identificazione, ad esempio l'alias o l'identificatore univoco globale (GUID), non sono accettate. Non è possibile utilizzare insieme i parametri OrganizationalUnit e Identity. Non è possibile utilizzare il parametro Credential.
OrganizationalUnit	Facoltativo	Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter	Il parametro OrganizationalUnit restituisce solo gli oggetti dell'unità organizzativa specificata (OU, Organizational Unit).
ReadFromDomainController	Facoltativo	System.Management.Automation.SwitchParameter	Il parametro ReadFromDomainController consente di specificare che le informazioni sull'utente vengano lette da un controller di dominio nel dominio dell'utente. Se si imposta l'ambito del destinatario per includere tutti i destinatari nella foresta e non si utilizza questo parametro, è possibile che le informazioni sull'utente vengano lette dal catalogo globale con informazioni scadute. Se si utilizza questo parametro, per ottenere le informazioni possono essere necessarie più letture. Nota Per impostazione predefinita, l'ambito dei destinatari è impostato sul dominio che ospita i server Exchange.
RecipientTypeDetails	Facoltativo	Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[]	Il parametro RecipientTypeDetails consente di specificare il tipo di destinatari restituiti. I tipi di destinatari in Microsoft Exchange Server 2007 sono suddivisi in tipi e sottotipi. Ciascun tipo di destinatario include tutte le proprietà comuni per tutti i sottotipi. Ad esempio, il tipo UserMailbox rappresenta un account utente in Active Directory con una cassetta postale associata. Poiché esistono molti tipi di cassette postali, ciascuno è identificato dal parametro RecipientTypeDetails. Ad esempio, nella cassetta postale di una sala riunioni il parametro RecipientTypeDetails è impostato su ConferenceRoomMailbox, mentre nella cassetta postale di un utente il parametro RecipientTypeDetails è impostato su UserMailbox. Di seguito sono riportati i dettagli del tipo di destinatario disponibile per questo parametro: ConferenceRoomMailbox DisabledUser EquipmentMailbox LegacyMailbox LinkedMailbox UserMailbox MailUser User
ResultSize	Facoltativo	Microsoft.Exchange.Data.Unlimited	Il parametro ResultSize imposta il numero massimo di risultati da restituire.
Sortby	Facoltativo	System.String	Il parametro SortBy ordina per singolo attributo in ordine crescente.

Tipi di input

Tipi restituiti

Errori

Errore	Descrizione

Eccezioni

Eccezioni	Descrizione

Esempio

Nel primo esempio vengono recuperate le informazioni sugli utenti dell'unità organizzativa "Marketing".

Nel secondo esempio viene utilizzato il parametro Filter per recuperare le informazioni su tutti gli utenti il cui titolo contiene alla fine la parola "Manager".

Get-User -OrganizationalUnit "Marketing"
Get-User -Filter {Title -like '*Manager'}

È possibile utilizzare qualsiasi attributo utente Active Directory per creare una stringa di filtro per il parametro Filter nel cmdlet Get-User. Per ulteriori informazioni sugli operatori di confronto che è possibile utilizzare nella stringa di filtro, vedere Operatori di confronto.

Share via