Linux 用 DSC の nxUser リソース
PowerShell Desired State Configuration (DSC) の nxUser リソースは、Linux ノード上でローカル ユーザーを管理するためのメカニズムを備えています。
構文
nxUser <string> #ResourceName
{
UserName = <string>
[ FullName = <string> ]
[ Description = <string> ]
[ Password = <string> ]
[ Disabled = <bool> ]
[ PasswordChangeRequired = <bool> ]
[ HomeDirectory = <string> ]
[ GroupID = <string> ]
[ DependsOn = <string[]> ]
[ Ensure = <string> { Absent | Present } ]
}
Properties
プロパティ | 特定の状態を保証するアカウント名を示します。 |
---|---|
UserName | ファイルまたはディレクトリの状態を保証する場所を指定します。 |
FullName | ユーザー アカウントに使用するフルネームを表す文字列。 |
説明 | ユーザー アカウントの説明。 |
Password | Linux コンピューターの適切な形式でのユーザー パスワードのハッシュ。 通常、これはソルト化ハッシュ SHA-256 または SHA-512 です。 Debian および Ubuntu Linux では、この値は、mkpasswd コマンドを使用して生成できます。 他の Linux ディストリビューションの場合は、Python の暗号ライブラリの crypt メソッドを使用してハッシュを生成できます。 |
無効 | アカウントが有効かどうかを示します。 このアカウントを無効にするには、このプロパティを $true に設定し、有効にするには $false に設定します。 |
PasswordChangeRequired | ユーザーがパスワードを変更できるかどうかを示します。 ユーザーがパスワードを変更できないようにするには、このプロパティを $true に設定し、ユーザーがパスワードを変更できるようにするには、$false に設定します。 既定値は $false です。 このプロパティは、以前存在しなかったユーザー アカウントを作成するときにのみ評価されます。 |
HomeDirectory | ユーザーのホーム ディレクトリ。 |
GroupID | ユーザーのプライマリ グループ ID。 |
共通プロパティ
プロパティ | 説明 |
---|---|
DependsOn | このリソースを構成する前に、他のリソースの構成を実行する必要があることを示します。 たとえば、最初に実行するリソース構成スクリプト ブロックの ID が ResourceName で、そのタイプが ResourceType である場合、このプロパティを使用する構文は DependsOn = "[ResourceType]ResourceName" になります。 |
Ensure | アカウントが存在するかどうかを指定します。 このアカウントの存在を保証するには、このプロパティを Present に設定し、アカウントが存在しないことを保証するには、Absent に設定します。 |
例
次の例は、ユーザー "monuser" が存在し、グループ "DBusers" のメンバーであることを保証しています。
Import-DSCResource -ModuleName nx
Node $node
{
nxUser UserExample{
UserName = "monuser"
Description = "Monitoring user"
Password = '$6$fZAne/Qc$MZejMrOxDK0ogv9SLiBP5J5qZFBvXLnDu8HY1Oy7ycX.Y3C7mGPUfeQy3A82ev3zIabhDQnj2ayeuGn02CqE/0'
Ensure = "Present"
HomeDirectory = "/home/monuser"
}
nxGroup GroupExample{
GroupName = "DBusers"
Ensure = "Present"
MembersToInclude = "monuser"
DependsOn = "[nxUser]UserExample"
}
}
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。