다음을 통해 공유


Set-LocalUser

로컬 사용자 계정을 수정합니다.

구문

Name (기본값)

Set-LocalUser
    [-Name] <String>
    [-AccountExpires <DateTime>]
    [-AccountNeverExpires]
    [-Description <String>]
    [-FullName <String>]
    [-Password <SecureString>]
    [-PasswordNeverExpires <Boolean>]
    [-UserMayChangePassword <Boolean>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObject

Set-LocalUser
    [-InputObject] <LocalUser>
    [-AccountExpires <DateTime>]
    [-AccountNeverExpires]
    [-Description <String>]
    [-FullName <String>]
    [-Password <SecureString>]
    [-PasswordNeverExpires <Boolean>]
    [-UserMayChangePassword <Boolean>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SecurityIdentifier

Set-LocalUser
    [-SID] <SecurityIdentifier>
    [-AccountExpires <DateTime>]
    [-AccountNeverExpires]
    [-Description <String>]
    [-FullName <String>]
    [-Password <SecureString>]
    [-PasswordNeverExpires <Boolean>]
    [-UserMayChangePassword <Boolean>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Set-LocalUser cmdlet은 로컬 사용자 계정을 수정합니다. 이 cmdlet은 로컬 사용자 계정의 암호를 재설정할 수 있습니다.

비고

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

예제

예제 1: 사용자 계정에 대한 설명 변경

Set-LocalUser -Name "Admin07" -Description "Description of this account."

이 명령은 Admin07이라는 사용자 계정에 대한 설명을 변경합니다.

예제 2: 계정의 암호 변경

$Password = Read-Host -AsSecureString
$UserAccount = Get-LocalUser -Name "User02"
$UserAccount | Set-LocalUser -Password $Password

첫 번째 명령은 Read-Host cmdlet을 사용하여 암호를 묻는 메시지를 표시합니다. 이 명령은 암호를 $Password 변수에 보안 문자열로 저장합니다.

두 번째 명령은 Get-LocalUser사용하여 User02라는 사용자 계정을 가져옵니다. 이 명령은 계정을 $UserAccount 변수에 저장합니다.

세 번째 명령은 $UserAccount저장된 사용자 계정의 새 암호를 설정합니다.

매개 변수

-AccountExpires

사용자 계정이 만료되는 시기를 지정합니다. DateTime 개체를 가져오려면 Get-Date cmdlet을 사용합니다.

계정이 만료되지 않도록 하려면 AccountNeverExpires 매개 변수를 지정합니다.

매개 변수 속성

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

매개 변수 집합

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

-AccountNeverExpires

계정이 만료되지 않음을 나타냅니다.

매개 변수 속성

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

매개 변수 집합

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

-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
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-FullName

사용자 계정의 전체 이름을 지정합니다. 전체 이름은 사용자 계정의 사용자 이름과 다릅니다.

매개 변수 속성

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

매개 변수 집합

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

-InputObject

이 cmdlet이 변경하는 사용자 계정을 지정합니다. 사용자 계정을 가져오려면 Get-LocalUser cmdlet을 사용합니다.

매개 변수 속성

형식:Microsoft.PowerShell.Commands.LocalUser
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

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

-Name

이 cmdlet이 변경하는 사용자 계정의 이름을 지정합니다.

매개 변수 속성

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

매개 변수 집합

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

-Password

사용자 계정의 암호를 지정합니다. 사용자 계정이 Microsoft 계정에 연결된 경우 암호를 설정하지 마세요.

Read-Host -AsSecureString, Get-Credential또는 ConvertTo-SecureString 사용하여 암호에 대한 SecureString 개체를 만들 수 있습니다.

암호 생략하고 NoPassword 매개 변수를 경우 Set-LocalUser 사용자의 암호를 묻는 메시지를 표시합니다.

매개 변수 속성

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

매개 변수 집합

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

-PasswordNeverExpires

암호가 만료되는지 여부를 나타냅니다.

매개 변수 속성

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

매개 변수 집합

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

-SID

이 cmdlet이 변경하는 사용자 계정의 SID(보안 ID)를 지정합니다.

매개 변수 속성

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

매개 변수 집합

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

-UserMayChangePassword

사용자가 사용자 계정의 암호를 변경할 수 있음을 나타냅니다.

매개 변수 속성

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

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값: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.LocalUser

로컬 사용자를 이 cmdlet으로 파이프할 수 있습니다.

String

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

SecurityIdentifier

SID를 이 cmdlet으로 파이프할 수 있습니다.

출력

None

이 cmdlet은 출력을 반환하지 않습니다.

참고

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

  • slu

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

  • 로컬
  • 액티브 디렉터리
  • Microsoft Entra 그룹
  • Microsoft 계정

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