Get-MailContact (RTM)

Articolo
08/07/2014

Si applica a: Exchange Server 2007

Ultima modifica dell'argomento: 2007-06-05

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

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

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

Descrizione dettagliata

Il cmdlet consente di recuperare tutti gli attributi del contatto specificato. Non è necessario alcun parametro. 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 Exchange View-Only 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	Il parametro specificato viene risolto utilizzando la risoluzione dei nomi ambigui (ANR). Gli attributi predefiniti ricercati sono i seguenti: 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, verrà richiesta la password dell'account prima di procedere.
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: unità organizzativa: 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 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 Exchange 2007 sono suddivisi in tipi e sottotipi. 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 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 specificato, il parametro restituisce tutti i risultati che corrispondono al filtro.
SortBy	Facoltativo	System.String	Il parametro consente di specificare l'attributo utilizzato per ordinare i risultati. Viene ordinato un attributo alla volta seguendo un ordine crescente.

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

Condividi tramite