.png)
Get-User
適用版本： Exchange Server 2013, Exchange Online
上次修改主題的時間： 2012-07-11
使用 Get-User 指令程式可擷取樹系中所有符合指定條件的使用者。
如需下方＜語法＞一節中的參數集的詳細資訊，請參閱語法。
Get-User [-Anr <String>] <COMMON PARAMETERS>
Get-User [-Identity <UserIdParameter>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-AccountPartition <AccountPartitionIdParameter>] [-Arbitration <SwitchParameter>] [-ConsumerNetID <NetID>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-Organization <OrganizationIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-PublicFolder <SwitchParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SoftDeletedUser <SwitchParameter>] [-SortBy <String>]
您必須已獲指派權限，才能執行此指令程式。 雖然這個指令程式的所有參數都已列於本主題中，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。 若要查看您需要的權限，請參閱收件者權限主題中的「收件者佈建權限」一節。
| 參數 | 必要 | 類型 | 描述 | ||
|---|---|---|---|---|---|
| AccountPartition | 選用 | Microsoft.Exchange.Configuration.Tasks.AccountPartitionIdParameter | 將保留此參數供 Microsoft 內部使用。 | ||
| Anr | 選用 | System.String | Anr 參數會指定用來執行模糊名稱解析 (ANR) 搜尋的字串。您可以指定部分字串，並搜尋具有與該字串相符之屬性的物件。所搜尋的預設屬性如下：
| ||
| Arbitration | 選用 | System.Management.Automation.SwitchParameter | Arbitration 參數會指定您正在執行命令的信箱是仲裁信箱。 仲裁信箱用於管理核准工作流程。 例如，仲裁信箱用於處理仲裁收件者及通訊群組成員資格的核准。 | ||
| ConsumerNetID | 選用 | Microsoft.Exchange.Data.NetID | 將保留此參數供 Microsoft 內部使用。 | ||
| Credential | 選用 | System.Management.Automation.PSCredential | Credential 參數會指定用於讀取 Active Directory 的帳戶。 此參數需要建立及傳遞認證物件。 此認證物件是透過使用 Get-Credential 指令程式來建立。 如需詳細資訊，請參閱 Get-Credential。 | ||
| DomainController | 選用 | Microsoft.Exchange.Data.Fqdn | DomainController 參數會指定從 Active Directory 擷取資料之網域控制站的完整網域名稱 (FQDN)。 | ||
| Filter | 選用 | System.String | Filter 參數會指出用來篩選收件者的 OPath 篩選器。 如需可篩選內容的相關資訊，請參閱-Filter 參數的可篩選內容。 | ||
| Identity | 選用 | Microsoft.Exchange.Configuration.Tasks.UserIdParameter | Identity 參數會指定使用者物件的識別碼。 此參數接受下列值：
| ||
| IgnoreDefaultScope | 選用 | System.Management.Automation.SwitchParameter | IgnoreDefaultScope 參數會指示命令略過 Exchange 管理命令介面工作階段的預設收件者範圍設定，並以整個樹系為範圍。 如此可讓命令存取目前不在預設範圍內的 Active Directory 物件。 使用 IgnoreDefaultScope 參數會產生下列限制：
| ||
| Organization | 選用 | Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter | Organization 參數會保留供 Microsoft 內部使用。 | ||
| OrganizationalUnit | 選用 | Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter | OrganizationalUnit 參數只會傳回指定組織單位 (OU) 中的物件。 | ||
| PublicFolder | 選用 | System.Management.Automation.SwitchParameter | PublicFolder 參數會指定您執行指令的使用者物件是否為公用資料夾信箱。公用資料夾信箱專為欲儲存公用資料夾階層與內容設計的信箱。系統需要此參數以擷取公用資料夾信箱的資訊。 | ||
| ReadFromDomainController | 選用 | System.Management.Automation.SwitchParameter | ReadFromDomainController 參數會指定從使用者網域的網域控制站讀取使用者資訊。如果您將收件者範圍設定為包含樹系中的所有收件者，而且如果您不使用此參數，則可能會從通用類別目錄讀取含有過時資訊的使用者資訊。如果使用此參數，則可能需要多次讀取才能取得資訊。
| ||
| RecipientTypeDetails | 選用 | Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[] | RecipientTypeDetails 參數會指定傳回的收件者類型。收件者類型可分為類型與子類型。每位收件者類型包含所有子類型的所有一般內容。例如，類型 您可以使用下列值：
| ||
| ResultSize | 選用 | Microsoft.Exchange.Data.Unlimited | ResultSize 參數會指定要傳回之結果的最大數量。 | ||
| SoftDeletedUser | 選用 | System.Management.Automation.SwitchParameter | 將保留此參數供 Microsoft 內部使用。 | ||
| SortBy | 選用 | System.String | SortBy 參數會指定用來排序的屬性。此參數會依單一屬性，以遞增順序排序。 |
附註： 若要查看此 Cmdlet 接受的輸入類型，請參閱 Cmdlet 輸入和輸出類型。 如果 Cmdlet 的 [輸入類型] 欄位是空的，表示 Cmdlet 不接受輸入資料。
若要查看此 Cmdlet 接受的傳回類型 (也就是所謂的輸出類型)，請參閱 Cmdlet 輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示 Cmdlet 不會傳回資料。
