Share via

Get-UMMailbox

  • Articolo

 

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

Ultima modifica dell'argomento: 2007-07-20

Il cmdlet Get-UMMailbox consente la visualizzazione delle proprietà di messaggistica unificata (UM, Unified Messaging) per un destinatario abilitato alla messaggistica unificata.

Sintassi

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

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

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

Descrizione dettagliata

Il cmdlet Get-UMMailbox recupera le proprietà di messaggistica unificata per una singola cassetta postale di messaggistica unificata. Può inoltre restituire un elenco delle cassette postali abilitate alla messaggistica unificata.

Per eseguire il cmdlet Get-UMMailbox, è necessario utilizzare un account che disponga della delega del ruolo Exchange Recipient Administrator.

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.

Parametri

Parametro Obbligatorio Tipo Descrizione

Anr

Facoltativo

System.String

Questo parametro consente di specificare una stringa in cui eseguire la risoluzione nome ambiguo (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

  • FirstName

  • LastName

  • Alias

Credential

Facoltativo

System.Management.Automation.PSCredential

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

DomainController

Facoltativo

Microsoft.Exchange.Data.Fqdn

Questo parametro consente di specificare il nome di dominio completo del controller di dominio che consente di scrivere questa modifica alla configurazione in Active Directory.

Filter

Facoltativo

System.String

Questo parametro consente di filtrare i risultati restituiti dal cmdlet.

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

Identity

Facoltativo

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Questo parametro consente di specificare l'utente da abilitare per la messaggistica unificata. Le variabili di questo parametro includono:

  • ADObjectID

  • GUID

  • Nome distinto (DN)

  • Dominio\Account

  • Nome dell'entità utente (UPN)

  • DN legacy di Exchange

  • Indirizzo SMTP

  • Alias

Questo parametro è obbligatorio se il parametro Instance non viene utilizzato.

IgnoreDefaultScope

Facoltativo

System.Management.Automation.SwitchParameter

Questo parametro impone 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. L'utilizzo del parametro IgnoreDefaultScope presenta 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 contemporaneamente i parametri OrganizationalUnit e Identity.

  • Non è possibile utilizzare il parametro Credential.

OrganizationalUnit

Facoltativo

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Questo parametro specifica un'unità organizzativa (OU, Organizational Unit) e viene utilizzata per limitare i risultati. Se si utilizza questo parametro, verranno recuperate 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

Questo parametro specifica che le informazioni utente saranno lette da un controller di dominio nel dominio dell'utente. Se l'ambito del destinatario è stato impostato per includere tutti i destinatari nella foresta e non si utilizza questo parametro, è possibile che le informazioni utente vengano lette da un catalogo globale con informazioni non aggiornate. Se si utilizza questo parametro, per ottenere le informazioni potrebbero essere necessarie più letture. Per impostazione predefinita, l'ambito del destinatario è impostato sul dominio che ospita i server di Exchange.

ResultSize

Facoltativo

Microsoft.Exchange.Data.Unlimited

Questo parametro consente di specificare un numero massimo di risultati da restituire. Se il numero massimo non viene specificato, il cmdlet restituirà tutti i risultati.

SortBy

Facoltativo

System.String

Il parametro 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

  • DisplayName

  • Name

I risultati verranno ordinati in ordine crescente.

Tipi di input

Tipo Descrizione

 

 

Tipi restituiti

Tipo Descrizione

 

 

Errori

Errore Descrizione

 

 

Esempio

Il primo esempio di codice visualizza un elenco formattato di tutte le cassette postali abilitate alla messaggistica unificata nella foresta Active Directory.

Il secondo esempio di codice visualizza le proprietà della cassetta postale di messaggistica unificata per yanli@contoso.com.

Get-UMMailbox | format-list

Get-UMMailbox -Identity yanli@contoso.com