共用方式為

Get-LocalUser

  • 參考
模組:
Microsoft.PowerShell.LocalAccounts

取得本機用戶帳戶。

語法

Get-LocalUser
   [[-Name] <String[]>]
   [<CommonParameters>]
Get-LocalUser
   [[-SID] <SecurityIdentifier[]>]
   [<CommonParameters>]

Description

Cmdlet Get-LocalUser 會取得本機用戶帳戶。 此 Cmdlet 會取得預設的內建用戶帳戶、您建立的本機用戶帳戶，以及您連線到Microsoft帳戶的本機帳戶。

注意

Microsoft.PowerShell.LocalAccounts 模組無法在 64 位系統上的 32 位 PowerShell 中使用。

範例

範例 1：使用其名稱取得帳戶

此範例會取得名為 AdminContoso02 的用戶帳戶。

Get-LocalUser -Name "AdminContoso02"

Name             Enabled Description
----             ------- -----------
AdminContoso02   True    Description of this account.

範例 2：取得連線至Microsoft帳戶的帳戶

此範例會取得連線至Microsoft帳戶的用戶帳戶。 此範例會針對位於 Outlook.com 的帳戶用戶名稱使用佔位元元值。

Get-LocalUser -Name "MicrosoftAccount\username@Outlook.com"

Name                                    Enabled  Description
----                                    -------  -----------
MicrosoftAccount\username@outlook.com  True     Description of this account.

範例 3：取得具有指定 SID 的帳戶

這個範例會取得具有指定 SID 的本機用戶帳戶。

Get-LocalUser -SID S-1-5-21-9526073513-1762370368-3942940353-500

Name          Enabled Description
----          ------- -----------
Administrator True    Built-in account for administering the computer/domain

參數

-Name

指定這個 Cmdlet 取得的使用者帳戶名稱陣列。 您可以使用通配符。

類型:String[]
Position:0
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:True

-SID

指定此 Cmdlet 取得之用戶帳戶的安全性識別子數位。

類型:SecurityIdentifier[]
Position:0
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

輸入

String

您可以使用管線將字串傳送至此 Cmdlet。

SecurityIdentifier

您可以使用管線將 SID 傳送至此 Cmdlet。

輸出

System.Management.Automation.SecurityAccountsManager.LocalUser[]

此 Cmdlet 會傳回本機用戶帳戶。

備註

Windows PowerShell 包含下列的 Get-LocalUser別名：

  • glu

LocalUser、LocalGroup 和 LocalPrincipal 物件的 PrincipalSource 屬性描述對象的來源。 可能的來源如下所示：

  • 區域
  • Active Directory
  • Microsoft Entra 群組
  • Microsoft 帳戶

只有 Windows 10、Windows Server 2016 和更新版本的 Windows 操作系統才支援 PrincipalSource 。 針對舊版，屬性是空白的。