Condividi tramite

Get-MailUser

  • Articolo

 

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-MailUser consente di recuperare da Active Directory gli attributi relativi alla posta dell'utente specificato.

Sintassi

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

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

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

Descrizione dettagliata

Il cmdlet Get-MailUser consente di recuperare tutti gli attributi relativi alla posta dell'utente specificato.

Per eseguire il cmdlet Get-MailUser, è 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.

Nota

Non tutti gli attributi dell'utente vengono recuperati dal cmdlet Get-MailUser. È possibile ottenere ulteriori attributi dell'utente con il cmdlet Get-User.

Parametri

Parametro Obbligatorio Tipo Descrizione

ANR

Facoltativo

System.String

Il parametro Anr consente di specificare una stringa in cui eseguire la risoluzione dei nomi ambigui (ANR). È possibile specificare una stringa parziale e cercare gli oggetti che hanno un attributo corrispondente alla stringa. Gli attributi predefiniti ricercati sono i seguenti:

  • CommonName (CN)

  • DisplayName (displayName)

  • FirstName (givenName)

  • LastName (sn)

  • Alias (mailNickname)

Credential

Facoltativo

System.Management.Automation.PSCredential

Il parametro Credential consente di specificare l'account da utilizzare per accedere ad Active Directory.

Se viene utilizzato il parametro Credential, verrà richiesta la password dell'account prima di procedere.

DomainController

Facoltativo

Microsoft.Exchange.Data.Fqdn

Per specificare il nome di dominio completo (FQDN) del controller di dominio che scrive la modifica alla configurazione in Active Directory, includere nel comando il parametro DomainController.

Filter

Facoltativo

System.String

Il parametro Filter viene utilizzato per filtrare l'elenco di destinatari restituito. È possibile specificare gli attributi da filtrare.

Per ulteriori informazioni sulle proprietà filtrabili, vedere Proprietà filtrabili per il parametro -Filter.

Identity

Facoltativo

Microsoft.Exchange.Configuration.Tasks.MailUserIdParameter

Il parametro Identity consente di identificare l'utente. È possibile includere l'ADObjectID, il nome distinto (DN), il DN legacy, il GUID, Domain\SamAccountName, il nome dell'entità utente (UPN), l'indirizzo di posta elettronica o l'alias dell'utente.

IgnoreDefaultScope

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro IgnoreDefaultScope consente di indicare al comando di ignorare l'impostazione dell'ambito destinatari predefinita di Exchange Management Shell e di utilizzare l'intera foresta come ambito. Ciò consente al comando di accedere agli oggetti di Active Directory che non si trovano correntemente nell'ambito predefinito. Utilizzando il parametro IgnoreDefaultScope si introducono le seguenti restrizioni:

  • Non è possibile utilizzare il parametro DomainController. Il comando utilizzerà automaticamente un server di catalogo globale appropriato.

  • È possibile utilizzare solo il DN per il parametro Identity. Non sono accettate altre forme di identificazione, ad esempio alias o GUID.

  • Non è possibile utilizzare il parametro OrganizationalUnit e il parametro Identity contemporaneamente.

  • Non è possibile utilizzare il parametro Credential.

OrganizationalUnit

Facoltativo

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Il parametro OrganizationalUnit consente di specificare un contenitore in cui limitare i risultati. È possibile utilizzare un'unità organizzativa o un dominio, specificando il nome canonico. Ad esempio:

  • unità organizzativa: westcoast.contoso.com/users

  • Dominio: westcoast.contoso.com

ReadFromDomainController

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro ReadFromDomainController consente di specificare che le informazioni sull'utente vengono lette da un controller di dominio nel dominio dell'utente. Se l'ambito del destinatario è impostato per includere tutti i destinatari della foresta e se non viene utilizzato questo parametro, è possibile che le informazioni sull'utente vengano lette da un catalogo globale con informazioni obsolete. Se viene utilizzato questo parametro, per ottenere le informazioni potrebbero essere necessarie più letture.

Nota

Per impostazione predefinita, l'ambito del destinatario è impostato sul dominio che ospita i server Exchange.

ResultSize

Facoltativo

Microsoft.Exchange.Data.Unlimited

Il parametro ResultSize consente di specificare il numero massimo di oggetti destinatario da restituire. Se non specificato, il parametro restituisce tutti i risultati che corrispondono al filtro.

SortBy

Facoltativo

System.String

Il parametro SortBy consente di specificare l'attributo utilizzato per ordinare i risultati. Viene ordinato un attributo alla volta seguendo un ordine crescente.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

 

Eccezioni

Eccezioni Descrizione

 

Esempio

Nel primo esempio il comando Get-MailUser viene utilizzato senza parametri per recuperare un elenco completo degli utenti abilitati alla posta per l'intera organizzazione di Exchange.

Nel secondo esempio vengono recuperate le impostazioni di posta per l'utente Ted e ne viene eseguito il piping al cmdlet Format-List per la visualizzazione.

Get-MailUser
Get-MailUser -Identity Ted | Format-List