Add-LocalGroupMember
將成員新增至本地組。
語法
Group
Add-LocalGroupMember
[-Group] <LocalGroup>
[-Member] <LocalPrincipal[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Add-LocalGroupMember
[-Member] <LocalPrincipal[]>
[-Name] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SecurityIdentifier
Add-LocalGroupMember
[-Member] <LocalPrincipal[]>
[-SID] <SecurityIdentifier>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Add-LocalGroupMember Cmdlet 會將使用者或群組新增至本機安全組。 指派給群組的所有許可權和許可權都會指派給該群組的所有成員。
本機電腦上的 Administrators 群組成員在該電腦上具有完全控制許可權。 限制 Administrators 群組中的用戶數目。
如果計算機已加入網域，您可以將用戶帳戶、計算機帳戶和群組帳戶從該網域和信任網域新增至本地組。
備註
如果計算機已加入網域，而您嘗試新增與網域成員名稱相同的本機使用者，則會新增網域成員。
範例
範例 1：將成員新增至 Administrators 群組
此命令會將數個成員新增至本機 Administrators 群組。 新的成員包括本機用戶帳戶、Microsoft帳戶、Microsoft Entra 帳戶和網域群組。 本範例會針對帳戶的用戶名稱使用佔位元值，Outlook.com。
Add-LocalGroupMember -Group "Administrators" -Member "Admin02", "MicrosoftAccount\username@Outlook.com", "AzureAD\DavidChew@contoso.com", "CONTOSO\Domain Admins"
參數
-Confirm
在執行 Cmdlet 之前，提示您進行確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Group
指定這個 Cmdlet 新增成員的安全組。
參數屬性
| 類型: | Microsoft.PowerShell.Commands.LocalGroup |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Group
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Member
指定此 Cmdlet 新增至安全組的使用者或群組陣列。 您可以依名稱、安全性識別碼 （SID） 或 LocalPrincipal 物件來指定使用者或群組。
參數屬性
| 類型: | Microsoft.PowerShell.Commands.LocalPrincipal[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Name
指定這個 Cmdlet 新增成員的安全組名稱。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Default
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SID
指定這個 Cmdlet 新增成員之安全組的安全性識別碼。
參數屬性
| 類型: | SecurityIdentifier |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
SecurityIdentifier
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 指令未執行。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 無線 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
System.Management.Automation.SecurityAccountsManager.LocalGroup
您可以使用管線將本機主體傳送至此 Cmdlet。
String
您可以使用管線將字串傳送到此 cmdlet。
SecurityIdentifier
您可以使用管線將 SID 傳送至此 Cmdlet。
輸出
None
此 Cmdlet 不會傳回任何輸出。
備註
Windows PowerShell 包含下列 Add-LocalGroupMember的別名：
algm
Microsoft.PowerShell.LocalAccounts 模組無法在 64 位系統上的 32 位 PowerShell 中使用。
PrincipalSource 屬性是在 LocalUser、LocalGroup和 LocalPrincipal 物件上的屬性，用於描述物件的來源。 可能的來源如下所示：
- 本地
- Active Directory
- Microsoft Entra 群組
- Microsoft帳戶
只有 Windows 10、Windows Server 2016 和更新版本的 Windows 操作系統才支援 PrincipalSource。 對於較早的版本，屬性是空白的。
