Condividi tramite

Get-Mailbox (RTM)

  • Articolo

 

Si applica a: Exchange Server 2007

Ultima modifica dell'argomento: 2007-09-19

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>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

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

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

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

get-Mailbox [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-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 Exchange View-Only Administrator

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

Per una valutazione precisa dello stato della quota di archiviazione corrente mediante il cmdlet Get-Mailbox, è necessario esaminare la proprietà UseDatabaseQuotaDefaults oltre alle proprietà ProhibitSendQuota, ProhibitSendReceiveQuota e IssueWarningQuota. Un valore True per la proprietà UseDatabaseQuotaDefaults significa che le impostazioni specifiche delle singole cassette postali vengono ignorate, mentre vengono utilizzati i limiti del database delle cassette postali. Se questa proprietà è impostata su True e le proprietà ProhibitSendQuota, ProhibitSendReceiveQuota e IssueWarningQuota sono impostate su un valore illimitato, le dimensioni della cassetta postale non sono illimitate. 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 False per la proprietà UseDatabaseQuotaDefaults significa che vengono utilizzate le impostazioni delle singole cassette postali.

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 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 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 (Distinguished Name, DN)

  • Dominio\Account

  • Nome dell'entità utente (UPN, User principal name)

  • DN legacy di Exchange

  • Indirizzo SMTP

  • Alias

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 consente di specificare che le informazioni sull'utente vengano lette da un controller di dominio nel dominio dell'utente. Se l'ambito dei destinatari viene impostato in modo da includere tutti i destinatari nella foresta e se questo parametro non viene utilizzato, è possibile che le informazioni sull'utente vengano lette da un catalogo globale con informazioni obsolete. Se si utilizza questo parametro, potrebbero essere 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 suddivisi 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

  • Nome

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