Condividi tramite

Get-UMMailbox (RTM)

  • Articolo

 

Si applica a: Exchange Server 2007

Ultima modifica dell'argomento: 2007-06-11

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

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

Get-UMMailbox [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-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 seguente delega:

  • Ruolo Exchange Recipient 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.

Parametri

Parametro Obbligatorio Tipo Descrizione

Anr

Facoltativo

System.String

Questo parametro specifica una stringa in cui eseguire la risoluzione dei nomi ambigui. È 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

Per specificare il nome di dominio completo (FQDN) del controller di dominio che consente di scrivere le modifiche alla configurazione nel servizio directory di Active Directory, includere nel cmdlet il parametro DomainController.

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 se l'utente è abilitato alla messaggistica unificata. Le variabili di questo parametro sono le seguenti:

  • ADObjectID

  • GUID

  • Nome distinto (DN)

  • Dominio\Account

  • Nome dell'entità utente (UPN)

  • DN legacy di Exchange

  • Indirizzo SMTP

  • Alias

Questo parametro è necessario se non si utilizza il parametro Instance.

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

  • Nome

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