Condividi tramite

Get-Recipient (RTM)

  • Articolo

 

Si applica a: Exchange Server 2007

Ultima modifica dell'argomento: 2008-04-16

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

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

get-Recipient [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-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

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:

  • Unità organizzativa: 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.

RecipientType

Facoltativo

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

Il parametro RecipientType è un filtro che consente di specificare il tipo di destinatario da includere nell'elenco indirizzi. È possibile utilizzare uno o più dei seguenti tipi:

  • UserMailbox

  • MailUser

  • MailContact

  • MailUniversalDistributionGroup

  • MailUniversalSecruityGroup

  • 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

  • Nome

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 nell'ambito dell'organizzazione e come ordinarli in base al nome.

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