Get-Contact
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-Contact consente di recuperare le informazioni su un contatto specifico o su più contatti.
Sintassi
Get-Contact [-Identity <ContactIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-Contact [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-Contact [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Descrizione dettagliata
Il cmdlet Get-Contact esegue query delle proprietà di un contatto specifico o di oggetti destinatari di contatti nel servizio directory di Active Directory.
Per eseguire il cmdlet Get-Contact, è 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 Exchange Server 2007, vedere Considerazioni sulle autorizzazioni.
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Anr |
Facoltativo |
System.String |
Il parametro Anr viene utilizzato per cercare oggetti che corrispondono a una parte di una stringa. È una ricerca analoga a quella eseguita utilizzando i caratteri jolly. |
Credential |
Facoltativo |
System.Management.Automation.PSCredential |
Il parametro Credential consente di specificare l'account utilizzato per eseguire le query in Active Directory delle credenziali del contatto. |
DomainController |
Facoltativo |
Microsoft.Exchange.Data.Fqdn |
Per specificare il nome di dominio completo (FQDN) 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 Filter consente di specificare un insieme di attributi utilizzato per limitare i destinatari restituiti dalla query. Per ulteriori informazioni sulle proprietà filtrabili, vedere Proprietà filtrabili per il parametro -Filter. |
Identity |
Facoltativo |
Microsoft.Exchange.Configuration.Tasks.ContactIdParameter |
Il parametro Identity accetta uno dei seguenti valori:
|
IgnoreDefaultScope |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro IgnoreDefaultScope consente di indicare 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 non si trovano correntemente nell'ambito predefinito. L'utilizzo del parametro IgnoreDefaultScope presenta le seguenti restrizioni:
|
OrganizationalUnit |
Facoltativo |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
Il parametro OrganizationalUnit consente di restituire gli oggetti solo dall'unità organizzativa (OU, organizational unit) specificata. |
ReadFromDomainController |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro ReadFromDomainController specifica che le informazioni relative all'utente sono lette da un controller di dominio nel dominio dell'utente. Se si imposta l'ambito destinatari all'inclusione di tutti i destinatari della foresta non utilizzando questo parametro, è possibile che le informazioni relative all'utente siano lette da un catalogo globale con informazioni non aggiornate. Utilizzando questo parametro, è possibile che siano 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 ConferenceRoomMailbox, 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:
|
ResultSize |
Facoltativo |
Microsoft.Exchange.Data.Unlimited |
Il parametro ResultSize consente di specificare il numero massimo di risultati da restituire. |
SortBy |
Facoltativo |
System.String |
Il parametro SortBy consente di ordinare in base a un singolo attributo in ordine crescente. |
Tipi di input
Tipi restituiti
Errori
| Errore | Descrizione |
|---|---|
|
|
Eccezioni
| Eccezioni | Descrizione |
|---|---|
|
Esempio
In questo esempio, il comando Get-Contact recupera il contatto Ted Bremer e esegue il pipelining dell'oggetto al comando Format-List per visualizzare le informazioni sul contatto.
Get-Contact -Identity TedBremer | Format-List