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 그룹의 사용자 수를 제한합니다.

컴퓨터가 할 일기본 조인된 경우 사용자 계정, 컴퓨터 계정 및 그룹 계정을 로컬 그룹에 추가할 수 있습니다기본 신뢰할 수 있는 기본.

참고 항목

컴퓨터가 할 일기본 조인되어 있고 do의 멤버와 이름이 같은 로컬 사용자를 추가하려고 하면기본 do기본 멤버가 추가됩니다.

예제

예제 1: 관리istrators 그룹에 멤버 추가

이 명령은 로컬 관리istrators 그룹에 여러 멤버를 추가합니다. 새 멤버에는 로컬 사용자 계정, Microsoft 계정, Microsoft Entra 계정 및 do기본 그룹이 포함됩니다. 이 예제에서는 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(보안 ID) 또는 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이 멤버를 추가하는 보안 그룹의 보안 ID를 지정합니다.

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

Microsoft.PowerShell.LocalAccounts 모듈은 64비트 시스템의 32비트 PowerShell에서 사용할 수 없습니다.

PrincipalSource 속성은 개체의 원본을 설명하는 LocalUser, LocalGroup 및 LocalPrincipal 개체의 속성입니다. 가능한 원본은 다음과 같습니다.

  • 로컬
  • Active Directory
  • Microsoft Entra 그룹
  • Microsoft 계정

PrincipalSource 는 Windows 10, Windows Server 2016 이상 버전의 Windows 운영 체제에서만 지원됩니다. 이전 버전의 경우 속성은 비어 있습니다.