Share via

Get-Recipient

  • 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-Recipient consente di restituire un elenco di oggetti destinatario dal servizio directory di Active Directory.

Sintassi

get-Recipient [-Identity <RecipientIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientType <RecipientType[]>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-Recipient [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientPreviewFilter <String>] [-RecipientType <RecipientType[]>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

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

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

Descrizione dettagliata

Il cmdlet Get-Recipient consente di recuperare gli attributi del destinatario specificato. Non è necessario alcun parametro. Se il cmdlet viene eseguito senza alcun parametro, verrà restituito l'elenco completo dei destinatari relativo all'organizzazione.

Per eseguire il cmdlet Get-Recipient, è 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 consente di specificare una stringa in cui eseguire la risoluzione dei nomi ambigui (ANR). È possibile specificare una stringa parziale e cercare gli oggetti con un attributo che corrisponda alla stringa. Gli attributi predefiniti ricercati sono:

  • CommonName (CN)

  • DisplayName (displayName)

  • FirstName (givenName)

  • LastName (sn)

  • Alias (mailNickname)

Credential

Facoltativo

System.Management.Automation.PSCredential

Il parametro Credential consente di specificare il nome utente e la password da utilizzare per accedere a 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 (FQDN) del controller di dominio che scrive la modifica alla configurazione in Active Directory, includere nel comando il parametro DomainController.

Filter

Facoltativo

System.String

Il parametro Filter consente di specificare uno o più attributi utilizzati per limitare il numero dei destinatari restituiti dalla query. Questo parametro non può essere utilizzato con il parametro Identity o con il parametro Anr.

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

Identity

Facoltativo

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

Il parametro Identity consente di identificare il destinatario. È possibile utilizzare uno dei seguenti valori:

  • GUID

  • Domain\Account

  • Nome dell'entità utente (UPN, User principal name)

  • LegacyExchangeDN

  • Indirizzo SMTP (Simple Mail Transfer Protocol)

  • Nome

  • Alias

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 insieme i parametri OrganizationalUnit e Identity.

  • Non è possibile utilizzare il parametro Credential.

OrganizationalUnit

Facoltativo

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Il parametro OrganizationalUnit consente di specificare un'unità organizzativa o un nome canonico di dominio e viene utilizzato per limitare i risultati. Se si utilizza questo parametro, si otterranno solo i destinatari relativi al contenitore specificato. Ad esempio:

  • OU: westcoast.contoso.com/users

  • Dominio: westcoast.contoso.com

ReadFromDomainController

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro ReadFromDomainController consente di specificare che le informazioni sull'utente vengano 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 dei destinatari è impostato sul dominio che ospita i server Exchange.

RecipientPreviewFilter

Facoltativo

System.String

Utilizzare il parametro RecipientPreviewFilter per specificare un filtro destinatario che definirà i destinatari restituiti da questo comando. È possibile creare un filtro destinatario personalizzato per un gruppo di distribuzione dinamico, un elenco indirizzi o un criterio dell'indirizzo di posta elettronica. Per verificare che il filtro destinatario specificato restituisca i destinatari desiderati, passare il filtro OPATH specificato nella proprietà RecipientFilter per quel gruppo di distribuzione dinamico, elenco indirizzi o criterio dell'indirizzo di posta elettronica al parametro RecipientPreviewFilter e visualizzare l'anteprima dell'elenco dei destinatari.

RecipientType

Facoltativo

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

Il parametro RecipientType consente di specificare il tipo di destinatari restituiti. È possibile utilizzare uno o più dei seguenti tipi:

  • UserMailbox

  • MailUser

  • MailContact

  • MailUniversalDistributionGroup

  • MailUniversalSecurityGroup

  • MailNonUniversalGroup

  • DynamicDistributionGroup

  • PublicFolder

RecipientTypeDetails

Facoltativo

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

Il parametro RecipientTypeDetails consente di specificare il tipo di destinatari restituiti. I tipi di destinatari in Microsoft Exchange Server 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. Poiché esistono molti tipi di cassette postali, ciascuno è 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 comando, i dettagli del tipo di destinatario disponibili sono i seguenti:

  • ConferenceRoomMailbox

  • EquipmentMailbox

  • LegacyMailbox

  • LinkedMailbox

  • UserMailbox

  • MailContact

  • DynamicDistributionGroup

  • MailForestContact

  • MailNonUniversalGroup

  • MailUniversalDistributionGroup

  • MailUniversalSecurityGroup

  • MailUser

  • PublicFolder

  • SharedMailbox

ResultSize

Facoltativo

Microsoft.Exchange.Data.Unlimited

Il parametro ResultSize consente di specificare il numero massimo di risultati da restituire. Se si desidera restituire tutti i destinatari che corrispondono al filtro, utilizzare il valore "illimitato" per questo parametro. Il valore predefinito è 1000.

SortBy

Facoltativo

System.String

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

Tipi restituiti

Errori

Errore Descrizione

   

 

Eccezioni

Eccezioni Descrizione

  

 

Esempio

Nel primo esempio viene descritto come ottenere informazioni su tutti i destinatari nell'ambito dell'organizzazione.

Nel secondo esempio viene descritto come ottenere informazioni su tutti i contatti abilitati alla posta nell'ambito dell'organizzazione e come ordinarli in base al nome.

Get-Recipient -ResultSize unlimited
Get-Recipient -RecipientType MailContact -SortBy Name