Rename-LocalUser
重新命名本機用戶帳戶。
Syntax
Rename-LocalUser
[-InputObject] <LocalUser>
[-NewName] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Rename-LocalUser
[-Name] <String>
[-NewName] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Rename-LocalUser
[-NewName] <String>
[-SID] <SecurityIdentifier>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Cmdlet 會 Rename-LocalUser
重新命名本機用戶帳戶。
注意
64 位系統上的 32 位 PowerShell 中無法使用 Microsoft.PowerShell.LocalAccounts 模組。
範例
範例 1:重新命名用戶帳戶
Rename-LocalUser -Name "Admin02" -NewName "AdminContoso02"
此命令會重新命名名為 管理員 02 的用戶帳戶。
參數
-Confirm
執行 Cmdlet 之前先提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
指定此 Cmdlet 重新命名的用戶帳戶。 若要取得用戶帳戶,請使用 Get-LocalUser Cmdlet。
Type: | Microsoft.PowerShell.Commands.LocalUser |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
指定此 Cmdlet 重新命名的用戶帳戶名稱。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NewName
指定用戶帳戶的新名稱。
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SID
指定此 Cmdlet 重新命名之使用者帳戶的安全性識別碼 (SID)。
Type: | SecurityIdentifier |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
System.Management.Automation.SecurityAccountsManager.LocalUser
您可以使用管線將本機用戶傳送至此 Cmdlet。
您可以使用管線將字串傳送至此 Cmdlet。
您可以使用管線將 SID 傳送至此 Cmdlet。
輸出
None
此 Cmdlet 不會傳回任何輸出。
備註
Windows PowerShell 包含下列的 Rename-LocalUser
別名:
rnlu
PrincipalSource 屬性是 LocalUser、LocalGroup 和 LocalPrincipal 物件上的屬性,可描述對象的來源。 可能的來源如下所示:
- 區域
- Active Directory
- Microsoft Entra 群組
- Microsoft 帳戶
只有 Windows 10、Windows Server 2016 和更新版本的 Windows 操作系統才支援 PrincipalSource 。 針對舊版,屬性是空白的。
相關連結
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應