Get-Group (RTM)

  • [アーティクル]

 

適用先: Exchange Server 2007

トピックの最終更新日: 2007-06-05

既存のグループに対してクエリを実行するには、Get-Group コマンドレットを使用します。

構文

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>]

解説

Get-Group コマンドレットは、Microsoft Windows のすべての既存グループから、指定したフィルタリング パラメータに一致するものを返します。

Get-Group コマンドレットを実行するには、使用するアカウントに次の権限が委任されている必要があります。

  • Exchange 表示専用管理者の役割

Microsoft Exchange Server 2007 を管理するために必要なアクセス許可、役割の委任、および権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。

パラメータ

パラメータ 必須かどうか 種類 説明

Anr

省略可能

System.String

Anr パラメータは、引数があいまいな名前の解決 (ANR) で解決されることを示します。

Credential

省略可能

System.Management.Automation.PSCredential

Credential パラメータには、Active Directory ディレクトリ サービスの読み取りに使用するアカウントを指定します。これは、グローバル カタログを指定するときに特に便利です。セキュリティ保護のため、パスワードを要求する必要があります。

DomainController

省略可能

Microsoft.Exchange.Data.Fqdn

Active Directory からデータを取得するドメイン コントローラの完全修飾ドメイン名 (FQDN) を指定するには、コマンドに DomainController パラメータを含めます。

Filter

省略可能

System.String

Filter パラメータには、受信者のフィルタ処理に使用するフィルタを指定します。

フィルタ可能なプロパティの詳細については、「-Filter パラメータのフィルタ可能なプロパティ」を参照してください。

Identity

省略可能

Microsoft.Exchange.Configuration.Tasks.GroupIdParameter

配布グループの Identity パラメータは、次のいずれかの形式で指定します。

  • GUID
  • 識別名 (DN)
  • ユーザー プリンシパル名 (UPN)
  • LegacyExchangeDN
  • ドメイン\アカウント名
  • エイリアス

OrganizationalUnit

省略可能

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

OrganizationalUnit パラメータは、結果を特定の組織単位 (OU) コンテナに限定します。

ReadFromDomainController

省略可能

System.Management.Automation.SwitchParameter

ReadFromDomainController パラメータには、ユーザー情報がユーザーのドメインのドメイン コントローラから読み取られることを指定します。フォレスト内のすべての受信者を含めるように受信者の範囲を設定した場合、このパラメータを使用しないと、情報が古いグローバル カタログからユーザー情報が読み取られる可能性があります。このパラメータを使用する場合は、情報を取得するために読み取りが数回必要になる場合があります。

note注 :
既定では、受信者の範囲は、Exchange サーバーをホストするドメインに設定されています。

RecipientTypeDetails

省略可能

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

RecipientTypeDetails パラメータには、返される受信者の種類を指定します。Microsoft Exchange Server 2007 の受信者の種類は、受信者の種類とサブタイプに分かれています。各受信者の種類には、すべてのサブタイプに共通するすべてのプロパティが含まれています。たとえば、UserMailbox は、関連付けられたメールボックスを持つ Active Directory のユーザー アカウントを表します。メールボックスには種類が複数あるため、各メールボックスの種類は RecipientTypeDetails パラメータによって識別されます。たとえば、会議室メールボックスは RecipientTypeDetails が ConferenceRoomMailbox に設定され、ユーザー メールボックスは RecipientTypeDetails が UserMailbox に設定されます。

このコマンドで使用できる受信者の種類の詳細を次に示します。

  • MailEnabledContact
  • MailEnabledForestContact
  • NonUniversalGroup
  • UniversalDistributionGroup
  • UniversalSecurityGroup

ResultSize

省略可能

Microsoft.Exchange.Data.Unlimited

ResultSize パラメータには、返されるメンバの最大数を指定します。

SortBy

省略可能

System.String

SortBy 属性は、結果の並べ替えに使用します。

入力の種類

戻り値の種類

エラー

エラー 説明

例外

例外 説明

例

次のコードは、Get‑Group コマンドの使用例です。この例では、Get-Group コマンドはパラメータを指定せずに使用され、Active Directory 内のすべてのグループが返されます。

Get-Group

参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。