다음을 통해 공유

New-LocalGroup

모듈:
Microsoft.PowerShell.LocalAccounts Module

로컬 보안 그룹을 만듭니다.

구문

Default (기본값) 

New-LocalGroup
    [-Description <String>]
    [-Name] <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

New-LocalGroup cmdlet은 보안 계정 관리자에 로컬 보안 그룹을 만듭니다.

비고

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

예제

예제 1: 보안 그룹 만들기

New-LocalGroup -Name "SecurityGroup04"

이 명령은 SecurityGroup04라는 그룹을 만듭니다.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

매개 변수 속성

형식:SwitchParameter
Default value:False
와일드카드 지원:False
DontShow:False
별칭:cf(cf)

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Description

그룹에 대한 주석을 지정합니다. 최대 길이는 256자입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-Name

그룹의 이름을 지정합니다. 최대 길이는 48자입니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:0
필수:True
파이프라인의 값:True
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

매개 변수 속성

형식:SwitchParameter
Default value:False
와일드카드 지원:False
DontShow:False
별칭:위스콘신

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

String

이 cmdlet에 문자열을 파이프할 수 있습니다.

출력

System.Management.Automation.SecurityAccountsManager.LocalGroup

이 cmdlet은 생성된 보안 그룹을 나타내는 LocalGroup 개체를 반환합니다.

참고

Windows PowerShell에는 다음과 같은 New-LocalGroup의 별칭이 포함되어 있습니다.

  • nlg

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

  • Local
  • Active Directory
  • AzureAD
  • MicrosoftAccount

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