Get-Group
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-Group consente di eseguire una query sui gruppi esistenti.
Sintassi
Get-Group [-Identity <GroupIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-Group [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-Group [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-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 Amministratore di Exchange solo visualizzazione
Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti di amministrazione 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à che è possibile filtrare, vedere Proprietà filtrabili per il parametro -Filter. |
Identity |
Facoltativo |
Microsoft.Exchange.Configuration.Tasks.GroupIdParameter |
Il parametro Identity del gruppo di distribuzione accetta uno dei seguenti formati:
|
IgnoreDefaultScope |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro IgnoreDefaultScope consente al comando di ignorare l'impostazione predefinita dell'ambito dei destinatari Exchange Management Shell e di utilizzare l'intera foresta come ambito. Ciò permette al comando di accedere agli oggetti Active Directory che non si trovano nell'ambito predefinito. L'utilizzo del parametro IgnoreDefaultScope presenta le seguenti restrizioni:
|
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 del destinatario è 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 di destinatari. Ogni tipo di destinatario contiene 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 diversi tipi di cassette postali, ogni tipo di cassetta postale è identificata 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 sul tipo di destinatario disponibili sono:
|
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