Set-LocalUser
로컬 사용자 계정을 수정합니다.
구문
Set-LocalUser
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-FullName <String>]
[-Name] <String>
[-Password <SecureString>]
[-PasswordNeverExpires <Boolean>]
[-UserMayChangePassword <Boolean>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-LocalUser
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-FullName <String>]
[-InputObject] <LocalUser>
[-Password <SecureString>]
[-PasswordNeverExpires <Boolean>]
[-UserMayChangePassword <Boolean>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-LocalUser
[-AccountExpires <DateTime>]
[-AccountNeverExpires]
[-Description <String>]
[-FullName <String>]
[-Password <SecureString>]
[-PasswordNeverExpires <Boolean>]
[-SID] <SecurityIdentifier>
[-UserMayChangePassword <Boolean>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
cmdlet은 Set-LocalUser 로컬 사용자 계정을 수정합니다. 이 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첫 번째 명령은 읽기-호스트 cmdlet을 사용하여 암호를 묻는 메시지를 표시합니다. 이 명령은 암호를 $Password 변수에 보안 문자열로 저장합니다.
두 번째 명령은 .를 사용하여 Get-LocalUserUser02라는 사용자 계정을 가져옵니다. 이 명령은 계정을 $UserAccount 변수에 저장합니다.
세 번째 명령은 에 저장된 $UserAccount사용자 계정에서 새 암호를 설정합니다.
매개 변수
-AccountExpires
사용자 계정이 만료되는 시기를 지정합니다. DateTime 개체를 가져오려면 cmdlet을 Get-Date 사용합니다.
계정이 만료되지 않도록 하려면 AccountNeverExpires 매개 변수를 지정합니다.
| 형식: | DateTime |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-AccountNeverExpires
계정이 만료되지 않음을 나타냅니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.
| 형식: | SwitchParameter |
| 별칭: | cf |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Description
사용자 계정에 대한 주석을 지정합니다. 최대 길이는 48자입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-FullName
사용자 계정의 전체 이름을 지정합니다. 전체 이름은 사용자 계정의 사용자 이름과 다릅니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-InputObject
이 cmdlet이 변경하는 사용자 계정을 지정합니다. 사용자 계정을 가져오려면 cmdlet을 Get-LocalUser 사용합니다.
| 형식: | Microsoft.PowerShell.Commands.LocalUser |
| Position: | 0 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Name
이 cmdlet이 변경하는 사용자 계정의 이름을 지정합니다.
| 형식: | String |
| Position: | 0 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Password
사용자 계정의 암호를 지정합니다. 사용자 계정이 Microsoft 계정에 연결된 경우 암호를 설정하지 마세요.
또는 암호에 대한 SecureString 개체를 만들 수 있습니다Read-Host -AsSecureString. Get-CredentialConvertTo-SecureString
암호 및 NoPassword 매개 변수 Set-LocalUser 를 생략하면 사용자의 암호를 묻는 메시지가 표시됩니다.
| 형식: | SecureString |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-PasswordNeverExpires
암호가 만료되는지 여부를 나타냅니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-SID
이 cmdlet이 변경하는 사용자 계정의 SID(보안 ID)를 지정합니다.
| 형식: | SecurityIdentifier |
| Position: | 0 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-UserMayChangePassword
사용자가 사용자 계정의 암호를 변경할 수 있음을 나타냅니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.
| 형식: | SwitchParameter |
| 별칭: | wi |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
System.Management.Automation.SecurityAccountsManager.LocalUser
로컬 사용자를 이 cmdlet으로 파이프할 수 있습니다.
이 cmdlet에 문자열을 파이프할 수 있습니다.
SID를 이 cmdlet으로 파이프할 수 있습니다.
출력
None
이 cmdlet은 출력을 반환하지 않습니다.
참고
Windows PowerShell에는 다음 별칭이 포함됩니다.Set-LocalUser
slu
PrincipalSource 속성은 개체의 원본을 설명하는 LocalUser, LocalGroup 및 LocalPrincipal 개체의 속성입니다. 가능한 원본은 다음과 같습니다.
- Local
- Active Directory
- Microsoft Entra 그룹
- Microsoft 계정
PrincipalSource 는 Windows 10, Windows Server 2016 이상 버전의 Windows 운영 체제에서만 지원됩니다. 이전 버전의 경우 속성은 비어 있습니다.
관련 링크
PowerShell