Condividi tramite

Get-MailContact

  • 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-MailContact consente di recuperare da Active Directory tutti gli attributi del contatto specificato.

Sintassi

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

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

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

Descrizione dettagliata

Il cmdlet consente di recuperare tutti gli attributi del contatto specificato. Non sono richiesti parametri. Se il cmdlet viene eseguito senza un parametro, viene restituito un elenco completo di contatti per l'organizzazione di Exchange.

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

Parametri

Parametro Obbligatorio Tipo Descrizione

ANR

Facoltativo

System.String

Il parametro specificato viene risolto utilizzando la risoluzione dei nomi ambigui (ANR). Gli attributi predefiniti ricercati sono:

  • CommonName (CN)

  • DisplayName (displayName)

  • FirstName (givenName)

  • LastName (sn)

  • Alias (mailNickname)

  • LegacyExchangeDN (legacyExchangeDN)

  • Name (name) (anzichè CommonName/CN)

  • EmailAddresses (proxyAddresses)

  • SamAccountName (samAccountName)

  • Office (physicalDeliveryOfficeName)

Credential

Facoltativo

System.Management.Automation.PSCredential

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

Se viene utilizzato il parametro Credential, prima di continuare il comando richiede la password per l'account.

DomainController

Facoltativo

Microsoft.Exchange.Data.Fqdn

Per specificare il nome di dominio completo del controller di dominio che consente di recuperare i dati da Active Directory, includere nel comando il parametro DomainController.

Filter

Facoltativo

System.String

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

Il parametro consente di identificare il contatto. È possibile includere il valore ADObjectID, il nome distinto, il valore LegacyExchangeDN, il GUID, il valore Domain\SamAccountName, il nome dell'entità utente, l'indirizzo di posta elettronica o l'alias del contatto.

OrganizationalUnit

Facoltativo

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Il parametro consente di specificare un contenitore in cui limitare i risultati. È possibile specificare un'unità organizzativa (OU) o un dominio. È inoltre necessario specificare il nome canonico. Ad esempio:

  • OU: westcoast.contoso.com/users

  • Dominio: westcoast.contoso.com

ReadFromDomainController

Facoltativo

System.Management.Automation.SwitchParameter

Questo parametro consente di specificare che le informazioni utente verranno lette da un controller di dominio nel dominio dell'utente. Se è stato impostato l'ambito destinatario in modo che nella foresta vengano inclusi tutti i destinatari e se non si utilizza questo parametro, le informazioni utente possono essere lette da un server di catalogo generale contenente informazioni obsolete. Se non si utilizza questo parametro, potrebbero essere necessarie più letture per recuperare le informazioni.

Nota

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

RecipientTypeDetails

Facoltativo

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

Il parametro RecipientTypeDetails consente di specificare il tipo di destinatari restituiti. I tipi di destinatari in Exchange 2007 sono suddivisi in tipi e sottotipi. Ogni tipo di destinatario contiene tutte le proprietà comuni a tutti i sottotipi. Ad esempio, il tipo UserMailbox rappresenta un account utente in Active Directory con una cassetta postale associata. Dal momento che esistono diversi tipi di cassette postali, ogni tipo viene identificato dal parametro RecipientTypeDetails. Ad esempio, nella cassetta postale di una sala riunioni il parametro RecipientTypeDetails è impostato su ConferenceRoomMailbox, mentre nella cassetta postale di un utente il parametro RecipientTypeDetails è impostato su UserMailbox.

Per questo cmdlet, i dettagli dei destinatari disponibili sono:

  • MailEnabledContact

  • MailEnabledForestContact

ResultSize

Facoltativo

Microsoft.Exchange.Data.Unlimited

Il parametro consente di specificare il numero totale di oggetti destinatario da restituire. Se non si specifica un valore, vengono restituiti tutti i risultati corrispondenti al filtro.

SortBy

Facoltativo

System.String

Il parametro consente di specificare l'attributo utilizzato per ordinare i risultati. L'ordinamento viene effettuato un attributo per volta, sempre in ordine crescente.

IgnoreDefaultScope

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro IgnoreDefaultScope indica al comando di ignorare l'impostazione predefinita dell'ambito del destinatario per Exchange Management Shell e utilizzare l'intera foresta come ambito. In questo modo il comando può accedere agli oggetti Active Directory che non si trovano correntemente nell'ambito predefinito. L'utilizzo del parametro IgnoreDefaultScope comporta le seguenti restrizioni:

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

  • È possibile utilizzare solo il nome distinto per il parametro Identity. Altre forme di identificazione, quali l'alias o il GUID, non sono accettate.

  • Non è possibile utilizzare assieme i parametri OrganizationalUnit e Identity.

  • Non è possibile utilizzare il parametro Credential.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

Eccezioni

Eccezioni Descrizione

Esempio

Nell'esempio riportato di seguito, il comando Get-MailContact viene utilizzato per recuperare il contatto abilitato alla posta denominato Ted.

Get-MailContact -Identity Ted | Format-List