Share via

Add-LocalGroupMember

  • 參考
模組:
Microsoft.PowerShell.LocalAccounts

將成員新增至本地組。

Syntax

Add-LocalGroupMember
   [-Group] <LocalGroup>
   [-Member] <LocalPrincipal[]>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-LocalGroupMember
   [-Member] <LocalPrincipal[]>
   [-Name] <String>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-LocalGroupMember
   [-Member] <LocalPrincipal[]>
   [-SID] <SecurityIdentifier>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Cmdlet 會將 Add-LocalGroupMember 使用者或群組新增至本機安全組。 指派給群組的所有許可權和許可權都會指派給該群組的所有成員。

本機電腦上的 管理員 istrators 群組成員在該電腦上具有 「完全控制」許可權。 限制 管理員 istrators 群組中的用戶數目。

如果計算機已加入網域，您可以將用戶帳戶、計算機帳戶和群組帳戶從該網域和信任網域新增至本地組。

注意

如果計算機已加入網域，而您嘗試新增與網域成員名稱相同的本機使用者，則會新增網域成員。

範例

範例 1：將成員新增至 管理員 istrators 群組

此命令會將數個成員新增至本機 管理員 istrators 群組。 新的成員包括本機用戶帳戶、Microsoft 帳戶、Microsoft Entra 帳戶和網域群組。 本範例會針對帳戶的用戶名稱使用佔位元值，Outlook.com。

Add-LocalGroupMember -Group "Administrators" -Member "Admin02", "MicrosoftAccount\username@Outlook.com", "AzureAD\DavidChew@contoso.com", "CONTOSO\Domain Admins"

參數

-Confirm

執行 Cmdlet 之前先提示您確認。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Group

指定這個 Cmdlet 新增成員的安全組。

Type:Microsoft.PowerShell.Commands.LocalGroup
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Member

指定此 Cmdlet 新增至安全組的使用者或群組陣列。 您可以依名稱、安全性識別碼 （SID） 或 LocalPrincipal 物件來指定使用者或群組。

Type:Microsoft.PowerShell.Commands.LocalPrincipal[]
Position:1
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:False
Accept wildcard characters:False

-SID

指定這個 Cmdlet 新增成員之安全組的安全性識別碼。

Type:SecurityIdentifier
Position:0
Default value:None
Required:True
Accept pipeline input:False
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.LocalGroup

您可以使用管線將本機主體傳送至此 Cmdlet。

String

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

SecurityIdentifier

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

輸出

None

此 Cmdlet 不會傳回任何輸出。

備註

Windows PowerShell 包含下列的 Add-LocalGroupMember別名：

  • algm

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

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

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

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