Condividi tramite

Get-Group (RTM)

  • Articolo

 

Si applica a: Exchange Server 2007

Ultima modifica dell'argomento: 2007-06-05

Il cmdlet Get-Group consente di eseguire una query sui gruppi esistenti.

Sintassi

Get-Group [-Identity <GroupIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

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

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

Descrizione dettagliata

Il cmdlet Get-Group restituisce tutti i gruppi esistenti in Microsoft Windows che soddisfano i parametri del filtro specificati.

Per eseguire il cmdlet Get-Group, è 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 Anr indica che l'argomento verrà risolto utilizzando la risoluzione dei nomi ambigui (ANR, Ambiguous Name Resolution).

Credential

Facoltativo

System.Management.Automation.PSCredential

Il parametro Credential specifica l'account da utilizzare per leggere il servizio directory di Active Directory. Questa soluzione è particolarmente utile quando si specifica il catalogo globale. La password deve essere richiesta in modalità protetta.

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 specifica il filtro da utilizzare per i destinatari.

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

Identity

Facoltativo

Microsoft.Exchange.Configuration.Tasks.GroupIdParameter

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

  • GUID

  • Nome distinto (Distinguished Name, DN)

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

  • DN legacy di Exchange

  • Dominio\Nome account

  • Alias

OrganizationalUnit

Facoltativo

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Il parametro OrganizationalUnit limita i risultati a un contenitore specifico di unità organizzative (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 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:

  • MailEnabledContact

  • MailEnabledForestContact

  • NonUniversalGroup

  • UniversalDistributionGroup

  • UniversalSecurityGroup

ResultSize

Facoltativo

Microsoft.Exchange.Data.Unlimited

Il parametro ResultSize specifica il numero massimo di membri che verrà restituito.

SortBy

Facoltativo

System.String

L'attributo SortBy viene utilizzato per ordinare i risultati.

Tipi di input

Tipi restituiti

Errori

Errore Descrizione

Eccezioni

Eccezioni Descrizione

Esempio

Il codice seguente è un esempio del comando Get-Group. In questo esempio, il comando Get-Group viene utilizzato senza parametri in modo da restituire tutti i gruppi presenti in Active Directory.

Get-Group