Get-User
適用版本: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
上次修改主題的時間: 2010-04-27
使用 Get-User 指令程式可擷取樹系中所有符合指定條件的使用者。
語法
get-User [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
get-User [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
get-User [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
詳細描述
不需要參數。不過,只能在 Get-User 命令中使用下列其中一個參數:Identity、Filter 或 Anr。
若要執行 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 參數會採用下列其中一個值:
|
||
IgnoreDefaultScope |
選用 |
System.Management.Automation.SwitchParameter |
IgnoreDefaultScope 參數會指示命令略過 Exchange 管理命令介面的預設收件者範圍設定,並以整個樹系作為範圍。如此可讓命令存取目前不在預設範圍內的 Active Directory 物件。使用 IgnoreDefaultScope 參數會產生下列限制:
|
||
OrganizationalUnit |
選用 |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
OrganizationalUnit 參數只會傳回指定組織單位 (OU) 中的物件。 |
||
ReadFromDomainController |
選用 |
System.Management.Automation.SwitchParameter |
ReadFromDomainController 參數指定從使用者網域的網域控制站讀取使用者資訊。如果您將收件者範圍設定為包含所有樹系中的收件者,且如果您不使用此參數,則可能會從通用類別目錄讀取含有過時資訊的使用者資訊。如果使用此參數,則可能需要多次讀取才能取得資訊。
|
||
RecipientTypeDetails |
選用 |
Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[] |
RecipientTypeDetails 參數指定傳回的收件者類型。Microsoft Exchange Server 2007 中的收件者類型可分為收件者類型與子類型。每位收件者類型包含所有子類型的所有一般內容。例如,類型 UserMailbox 代表 Active Directory 中,具有關聯信箱的使用者帳戶。因為有數個信箱類型,每個信箱類型是透過 RecipientTypeDetails 參數來加以識別。例如,會議室信箱的 RecipientTypeDetails 是設定為 ConferenceRoomMailbox,而使用者信箱的 RecipientTypeDetails 則是設定為 UserMailbox。 對於此參數,可用的收件者類型詳細資料為:
|
||
ResultSize |
選用 |
Microsoft.Exchange.Data.Unlimited |
ResultSize 參數會設定要傳回的結果筆數上限。 |
||
SortBy |
選用 |
System.String |
SortBy 參數會依單一屬性,以遞增順序排序。 |
輸入類型
傳回類型
錯誤
錯誤 | 描述 |
---|---|
|
|
例外狀況
例外狀況 | 描述 |
---|---|
|
|
範例
第一個範例會擷取您在行銷 OU 中的使用者相關資訊。
第二個範例會使用 Filter 參數來擷取標題結尾有文字 "Manager" 的所有使用者相關資訊。
Get-User -OrganizationalUnit "Marketing"
Get-User -Filter {Title -like '*Manager'}
您可以使用任何 Active Directory 使用者屬性,為 Get-User 指令程式中的 Filter 參數建構篩選字串。若要了解能在篩選字串中使用的比較運算子相關資訊,請參閱比較運算子。
若要確保您目前閱讀的是最新資訊,並尋找其他的 Exchange Server 2007 說明文件,請造訪 Exchange Server 技術資源中心.