Condividi tramite

Get-Mailbox

  • 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-Mailbox consente di visualizzare gli oggetti cassette postali e i relativi attributi, per compilare le pagine delle proprietà o per fornire informazioni sulle cassette postali ad altre attività.

Sintassi

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

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

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

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

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

Descrizione dettagliata

Il cmdlet Get-Mailbox recupera gli attributi e gli oggetti relativi a una cassetta postale. Non è necessario alcun parametro. Se il cmdlet viene utilizzato senza un parametro, vengono elencate tutte le cassette postali dell'organizzazione.

Per eseguire il cmdlet Get-Mailbox, è 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 Microsoft Exchange Server 2007, vedere Considerazioni sulle autorizzazioni.

Nota

Per valutare accuratamente lo stato effettivo della quota di archiviazione utilizzando il cmdlet Get-Mailbox, è necessario esaminare la proprietà UseDatabaseQuotaDefaults insieme alle proprietà ProhibitSendQuota, ProhibitSendReceiveQuota e IssueWarningQuota. Un valore corrispondente a Vero per la proprietà UseDatabaseQuotaDefaults significa che le impostazioni specifiche della cassetta postale sono ignorate e sono utilizzati i limiti relativi al database della cassetta postale. Se questa proprietà è impostata su Vero e le proprietà ProhibitSendQuota, ProhibitSendReceiveQuota e IssueWarningQuota sono impostate su un valore illimitato, la cassetta postale non ha una dimensione illimitata. Invece, è necessario fare riferimento ai limiti di archiviazione del database della cassetta postale per visualizzare quali sono i limiti relativi alla cassetta postale. Un valore corrispondente a Falso per la proprietà UseDatabaseQuotaDefaults significa che sono utilizzate le impostazioni specifiche della cassetta postale.

Parametri

Parametro Obbligatorio Tipo Descrizione

Anr

Facoltativo

System.String

Il parametro Anr specifica una stringa in cui eseguire la ricerca di risoluzione dei nomi ambigui. È possibile specificare una stringa parziale e cercare gli oggetti con un attributo che corrisponda alla stringa. Gli attributi predefiniti ricercati sono:

  • CommonName (CN)

  • DisplayName

  • FirstName

  • LastName

  • Alias

Credential

Facoltativo

System.Management.Automation.PSCredential

Il parametro Credential specifica il nome utente e la password da utilizzare per accedere al servizio directory di Active Directory.

Database

Facoltativo

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

Il parametro Database consente di specificare il database da cui ottenere la cassetta postale. È possibile utilizzare i seguenti valori:

  • GUID del database

  • Nome database

  • Nome server\nome database

  • Nome server\gruppo di archiviazione\nome database

Se non si specifica il nome del server, il cmdlet effettuerà la ricerca del database nel server locale. Se vi sono più database con lo stesso nome nello stesso server, è necessario specificare il gruppo di archiviazione.

Questo parametro non può essere utilizzato con il parametro Filter.

DomainController

Facoltativo

Microsoft.Exchange.Data.Fqdn

Il parametro DomainController specifica il controller di dominio da utilizzare per accedere a Active Directory. Utilizzare il nome di dominio completo (FQDN, Fully Qualified Domain Name) del controller di dominio che si desidera utilizzare.

Filter

Facoltativo

System.String

Il parametro Filter specifica uno o più attributi utilizzati per limitare le cassette postali restituite dalla query.

Questo parametro non può essere utilizzato con il parametro Database.

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

Identity

Facoltativo

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Il parametro Identity consente di identificare la cassetta postale. È possibile utilizzare uno dei seguenti valori:

  • GUID

  • Nome distinto (DN)

  • Dominio\Account

  • Nome dell'entità utente (UPN)

  • DN legacy di Exchange

  • Indirizzo SMTP

  • Alias

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 attualmente non si trovano 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 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 specifica un'unità organizzativa (OU) e viene utilizzato per limitare i risultati. Se si utilizza questo parametro, si otterranno solo le cassette postali relative al contenitore specificato. È possibile utilizzare l'unità organizzativa o il nome di dominio. Se si utilizza l'unità organizzativa, è necessario specificare il nome canonico dell'unità organizzativa.

ReadFromDomainController

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro ReadFromDomainController specifica che le informazioni relative all'utente sono lette da un controller di dominio nel dominio dell'utente. Se si imposta l'ambito destinatari all'inclusione di tutti i destinatari della foresta non utilizzando questo parametro, è possibile che le informazioni relative all'utente siano lette da un catalogo globale con informazioni non aggiornate. Utilizzando questo parametro, è possibile che siano necessarie più letture per ottenere le informazioni.

Nota

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

RecipientTypeDetails

Facoltativo

Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[]

Il parametro RecipientTypeDetails specifica il tipo di destinatari restituiti. I tipi di destinatari in Microsoft Exchange Server 2007 sono divisi in tipi e sottotipi di destinatari. 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. Data l'esistenza di diversi tipi di cassette postali, ciascuno di essi è identificato dal parametro RecipientTypeDetails. Ad esempio, nella cassetta postale di una sala riunioni il parametro RecipientTypeDetails è impostato su RoomMailbox, mentre nella cassetta postale di un utente il parametro RecipientTypeDetails è impostato su UserMailbox.

Nel caso di questo comando, i dettagli sul tipo di destinatario disponibili sono indicati di seguito:

  • RoomMailbox

  • EquipmentMailbox

  • LegacyMailbox

  • LinkedMailbox

  • UserMailbox

  • SharedMailbox

ResultSize

Facoltativo

Microsoft.Exchange.Data.Unlimited

Il parametro ResultSize consente di specificare il numero massimo di risultati da restituire. Se si desidera restituire tutte le cassette postali che soddisfano la query, utilizzare il valore "illimitato" per questo parametro. Il valore predefinito è 1000.

Server

Facoltativo

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Il parametro Server specifica un singolo server e viene utilizzato per limitare i risultati. Se si utilizza questo parametro, si otterranno solo le cassette postali che risiedono sul server specificato. Utilizzare il nome comune del server che si desidera specificare.

SortBy

Facoltativo

System.String

Il parametro SortBy consente di specificare l'attributo utilizzato per ordinare i risultati. È possibile ordinare un solo attributo alla volta. È possibile eseguire l'ordinamento in base ai seguenti attributi:

  • Alias

  • Nome visualizzato

  • Name

I risultati verranno ordinati in ordine crescente.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

 

Eccezioni

Eccezioni Descrizione

 

Esempio

Nel primo esempio viene descritto come ottenere un elenco di tutte le cassette postali dell'organizzazione.

Nel secondo esempio viene descritto come ottenere un elenco di tutte le cassette postali dell'organizzazione nel contenitore Utenti del dominio Contoso.com.

Nel terzo esempio viene descritto come ottenere tutte le cassette postali che si trovano nel dominio di DC01 risolte con la ricerca di risoluzione dei nomi ambigui mediante la stringa "Chr" Questa operazione restituisce le cassette postali di utenti come Chris Ashton, Christian Cletus e Christa Geller.

Get-Mailbox -ResultSize unlimited
Get-Mailbox -OrganizationalUnit Users
Get-Mailbox -Anr Chr -DomainController DC01