다음을 통해 공유

Add-LocalGroupMember

  • 참조
모듈:
Microsoft.PowerShell.LocalAccounts

로컬 그룹에 멤버를 추가합니다.

구문

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 로컬 보안 그룹에 사용자 또는 그룹을 추가합니다. 그룹에 할당된 모든 권한과 권한은 해당 그룹의 모든 구성원에게 할당됩니다.

로컬 컴퓨터의 Administrators 그룹 구성원은 해당 컴퓨터에 대한 모든 권한을 갖습니다. Administrators 그룹의 사용자 수를 제한합니다.

컴퓨터가 도메인에 가입된 경우 해당 도메인과 신뢰할 수 있는 도메인의 사용자 계정, 컴퓨터 계정 및 그룹 계정을 로컬 그룹에 추가할 수 있습니다.

참고 항목

컴퓨터가 도메인에 가입되어 있고 도메인의 멤버와 이름이 같은 로컬 사용자를 추가하려고 하면 도메인 멤버가 추가됩니다.

예제

예제 1: 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
별칭:cf
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Group

이 cmdlet에서 멤버를 추가할 보안 그룹을 지정합니다.

형식:Microsoft.PowerShell.Commands.LocalGroup
Position:0
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Member

이 cmdlet이 보안 그룹에 추가하는 사용자 또는 그룹의 배열을 지정합니다. 이름, SID(보안 ID) 또는 LocalPrincipal 개체로 사용자 또는 그룹을 지정할 수 있습니다.

형식:Microsoft.PowerShell.Commands.LocalPrincipal[]
Position:1
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Name

이 cmdlet에서 멤버를 추가할 보안 그룹의 이름을 지정합니다.

형식:String
Position:0
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SID

이 cmdlet이 멤버를 추가하는 보안 그룹의 보안 ID를 지정합니다.

형식:SecurityIdentifier
Position:0
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용: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 개체의 속성입니다. 가능한 원본은 다음과 같습니다.

  • Local
  • Active Directory
  • Microsoft Entra 그룹
  • Microsoft 계정

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