Condividi tramite


Get-DistributionGroup

 

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-DistributionGroup consente di eseguire query per i gruppi di distribuzione esistenti.

Sintassi

Get-DistributionGroup [-Identity <DistributionGroupIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

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

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

Descrizione dettagliata

È possibile utilizzare i gruppi di distribuzione per creare liste di distribuzione di posta elettronica e gruppi di protezione per assegnare autorizzazioni alle risorse condivise. I gruppi di distribuzione possono essere utilizzati solo con le applicazioni di posta elettronica (quali Exchange) per inviare messaggi di posta elettronica a insiemi di utenti. Il cmdlet Get-DistributionGroup consente di eseguire query per i gruppi di distribuzione esistenti.

Per eseguire il cmdlet Get-DistributionGroup, è 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 ANR consente di indicare che l'argomento sarà risolto utilizzando la risoluzione dei nomi ambigui (ANR, Ambiguous Name Resolution).

Credential

Facoltativo

System.Management.Automation.PSCredential

Il parametro Credential consente di indicare il dominio e il nome utente dell'account utilizzati per leggere il servizio directory di Active Directory.

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 indicare il filtro OPath utilizzato per filtrare i destinatari.

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

Identity

Facoltativo

Microsoft.Exchange.Configuration.Tasks.DistributionGroupIdParameter

Il parametro Identity del gruppo di distribuzione assume una delle seguenti forme:

  • GUID

  • Nome distinto (DN)

  • LegacyExchangeDN

  • Dominio\Nome account

  • Alias

IgnoreDefaultScope

Facoltativo

System.Management.Automation.SwitchParameter

Il parametro IgnoreDefaultScope indica al comando di ignorare l'impostazione predefinita dell'ambito dei destinatari 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.

ManagedBy

Facoltativo

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

Il parametro ManagedBy consente di indicare il nome distinto dell'utente o del contatto che gestisce il gruppo.

OrganizationalUnit

Facoltativo

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Il parametro OrganizationalUnit consente di limitare i risultati a uno specifico contenitore dell'unità organizzativa (OU, organizational unit).

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.

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:

  • MailNonUniversalGroup

  • MailUniversalDistributionGroup

  • MailUniversalSecurityGroup

ResultSize

Facoltativo

Microsoft.Exchange.Data.Unlimited

Il parametro ResultSize consente di indicare il numero massimo di oggetti destinatario che saranno restituiti.

SortBy

Facoltativo

System.String

L'attributo SortBy consente di ordinare i risultati.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

  

Eccezioni

Eccezioni Descrizione

  

Esempio

Di seguito viene riportato un codice di esempio del comando Get-DistributionGroup. In questo esempio, il comando Get-DistributionGroup recupera il gruppo Gruppo Distribuzione1 ed esegue il pipelining dell'oggetto al comando Format-List per visualizzare le informazioni sul gruppo di distribuzione.

Get-DistributionGroup -Identity "Distribution Group1" | Format-List