Condividi tramite


Get-User

 

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.