Get-User (RTM)

  • [アーティクル]

 

適用先: Exchange Server 2007

トピックの最終更新日: 2008-04-16

指定した条件に一致するすべてのユーザーをフォレストから取得するには、Get-User コマンドレットを使用します。

構文

get-User [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

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

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

解説

必須パラメータはありません。ただし、Get-User コマンドには、Identity、Filter、または Anr パラメータのいずれか 1 つを指定できます。

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

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

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.UserIdParameter

Identity パラメータには、次のいずれかの値を指定します。

  • GUID
  • 識別名 (DN)
  • ドメイン\アカウント
  • ユーザー プリンシパル名 (UPN)
  • 従来の Exchange DN
  • SMTP (簡易メール転送プロトコル) アドレス
  • エイリアス

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 に設定されます。

このパラメータには、以下に示す受信者の種類の詳細を指定できます。

  • ConferenceRoomMailbox
  • DisabledUser
  • EquipmentMailbox
  • LegacyMailbox
  • LinkedMailbox
  • UserMailbox
  • MailUser
  • User

ResultSize

省略可能

Microsoft.Exchange.Data.Unlimited

ResultSize パラメータには、返される結果の最大件数を設定します。

SortBy

省略可能

System.String

SortBy パラメータを指定すると、単一の属性の昇順で並べ替えられます。

入力の種類

戻り値の種類

エラー

エラー 説明

 

 

例外

例外 説明

 

 

例

最初の例では、Marketing OU 内のユーザーに関する情報を取得します。

2 番目の例では、Filter パラメータを使用して、役職 (Title) の最後に "Manager" という単語が付くすべてのユーザーに関する情報を取得します。

Get-User -OrganizationalUnit "Marketing"
Get-User -Filter {Title -like '*Manager'}

Get-User コマンドレットの Filter パラメータ用に、任意の Active Directory ユーザー属性を使用してフィルタ文字列を作成できます。フィルタ文字列で使用できる比較演算子の詳細については、「比較演算子」を参照してください。

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