Set-LocalGroup
로컬 보안 그룹을 변경합니다.
구문
InputObject
Set-LocalGroup
[-InputObject] <LocalGroup>
-Description <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Set-LocalGroup
[-Name] <String>
-Description <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SecurityIdentifier
Set-LocalGroup
[-SID] <SecurityIdentifier>
-Description <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Set-LocalGroup cmdlet은 로컬 보안 그룹을 변경합니다.
예제
예제 1: 그룹 설명 변경
Set-LocalGroup -Name "SecurityGroup04" -Description "This is a sample description."
이 명령은 로컬 그룹에 대한 설명을 변경합니다.
비고
Microsoft.PowerShell.LocalAccounts 모듈은 64비트 시스템의 32비트 PowerShell에서 사용할 수 없습니다.
매개 변수
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | False |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | cf(cf) |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Description
그룹에 대한 주석을 지정합니다. 최대 길이는 48자입니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-InputObject
이 cmdlet이 변경하는 보안 그룹을 지정합니다. 보안 그룹을 가져오려면 Get-LocalGroup cmdlet을 사용합니다.
매개 변수 속성
| 형식: | Microsoft.PowerShell.Commands.LocalGroup |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
InputObject
| Position: | 0 |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-Name
이 cmdlet이 변경하는 보안 그룹의 이름을 지정합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
Default
| Position: | 0 |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-SID
이 cmdlet이 변경하는 보안 그룹의 SID(보안 ID)를 지정합니다.
매개 변수 속성
| 형식: | SecurityIdentifier |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
SecurityIdentifier
| 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를 참조하세요.
입력
System.Management.Automation.SecurityAccountsManager.LocalGroup
보안 그룹을 이 cmdlet으로 파이프할 수 있습니다.
String
이 cmdlet에 문자열을 파이프할 수 있습니다.
SecurityIdentifier
SID를 이 cmdlet으로 파이프할 수 있습니다.
출력
None
이 cmdlet은 출력을 반환하지 않습니다.
참고
Windows PowerShell에는 다음과 같은 Set-LocalGroup의 별칭이 포함되어 있습니다.
slg
PrincipalSource 속성은 LocalUser, LocalGroup, 및 LocalPrincipal 개체의 원본을 설명하는 속성입니다. 가능한 원본은 다음과 같습니다.
- 로컬
- 액티브 디렉터리
- Microsoft Entra 그룹
- Microsoft 계정
PrincipalSource Windows 10, Windows Server 2016 이상 버전의 Windows 운영 체제에서만 지원됩니다. 이전 버전의 경우 속성은 비어 있습니다.
