DSC 사용자 리소스
적용 대상: Windows PowerShell 4.0, Windows PowerShell 5.x
Windows PowerShell DSC(필요한 상태 구성)의 사용자 리소스에서는 대상 노드에 있는 로컬 사용자 계정을 관리하는 메커니즘을 제공합니다.
참고
이 DSC 리소스에 대한 이 설명서에서는 버전 7.2 이전의 PowerShell에 포함된 버전을 다룹니다. PSDscResources 모듈에는 Microsoft에서 공식적으로 지원하는 새 DSC 리소스와 업데이트된 DSC 리소스가 포함되어 있습니다. PSDscResources 모듈은 PowerShell 갤러리에서 사용할 수 있습니다.
자세한 내용 및 업데이트된 설명서는 PSDscResources 참조 설명서를 참조하세요.
구문
User [string] #ResourceName
{
UserName = [string]
[ Description = [string] ]
[ Disabled = [bool] ]
[ FullName = [string] ]
[ Password = [PSCredential] ]
[ PasswordChangeNotAllowed = [bool] ]
[ PasswordChangeRequired = [bool] ]
[ PasswordNeverExpires = [bool] ]
[ DependsOn = [string[]] ]
[ Ensure = [string] { Absent | Present } ]
[ PsDscRunAsCredential = [PSCredential] ]
}
속성
속성 | Description |
---|---|
UserName | 특정 상태를 확인하려는 계정 이름을 나타냅니다. |
Description | 사용자 계정에 대해 사용할 설명을 나타냅니다. |
사용 안 함 | 계정이 사용되는지 여부를 나타냅니다. 이 계정을 사용하지 않도록 하려면 이 속성을 $true 로 설정하고, 사용하도록 하려면 $false 로 설정합니다. |
FullName | 사용자 계정에 대해 사용할 전체 이름으로 문자열을 나타냅니다. |
암호 | 이 계정에 사용할 암호를 나타냅니다. |
PasswordChangeNotAllowed | 사용자가 암호를 변경할 수 있는지 여부를 나타냅니다. 사용자가 암호를 변경할 수 없도록 하려면 이 속성을 $true 로 설정하고, 사용자가 암호를 변경할 수 있도록 하려면 $false 로 설정합니다. 기본값은 $false 입니다. |
PasswordChangeRequired | 사용자가 다음 로그인 시 암호를 변경해야 하는지 여부를 나타냅니다. 사용자가 암호를 변경해야 하는 경우 이 속성을 $true 로 설정합니다. 기본값은 $true 입니다. |
PasswordNeverExpires | 암호가 만료될지 여부를 나타냅니다. 이 계정에 대한 암호가 절대로 만료되지 않도록 하려면, 이 속성을 $true 로 설정합니다. 암호가 만료될 경우 $false 로 설정합니다. 기본값은 $false 입니다. |
공용 속성
속성 | Description |
---|---|
DependsOn | 이 리소스를 구성하려면 먼저 다른 리소스의 구성을 실행해야 함을 나타냅니다. 예를 들어, 먼저 실행하려는 리소스 구성 스크립트 블록의 ID가 ResourceName이고 해당 형식이 ResourceType일 경우, 이 속성을 사용하기 위한 구문은 DependsOn = "[ResourceType]ResourceName" 입니다. |
Ensure | 계정이 있는지 여부를 나타냅니다. 계정이 존재하도록 하려면 이 속성을 Present로 설정하고, 계정이 존재하지 않도록 하려면 Absent로 설정합니다. 기본값은 Present입니다. |
PsDscRunAsCredential | 전체 리소스를 실행하기 위한 자격 증명을 설정합니다. |
참고
PsDscRunAsCredential 공용 속성은 다른 자격 증명의 컨텍스트에서 DSC 리소스를 실행할 수 있도록 WMF 5.0에 추가되었습니다. 자세한 내용은 DSC 리소스로 자격 증명 사용을 참조하세요.
예제
User UserExample
{
Ensure = "Present" # To ensure the user account does not exist, set Ensure to "Absent"
UserName = "SomeName"
Password = $passwordCred # This needs to be a credential object
DependsOn = "[Group]GroupExample" # Configures GroupExample first
}
GitHub에서 Microsoft와 공동 작업
이 콘텐츠의 원본은 GitHub에서 찾을 수 있으며, 여기서 문제와 끌어오기 요청을 만들고 검토할 수도 있습니다. 자세한 내용은 참여자 가이드를 참조하세요.
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기