Recurso nxUser de DSC para Linux
O recurso nxUser na Configuração de Estado Desejado (DSC) do PowerShell fornece um mecanismo para gerenciar usuários locais em um nó do Linux.
Sintaxe
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 } ]
}
Propriedades
Propriedade | Indica o nome da conta para a qual você deseja garantir um estado específico. |
---|---|
UserName | Especifica o local onde você deseja garantir o estado de um arquivo ou diretório. |
FullName | Uma cadeia de caracteres que contém o nome completo que deve ser usado para a conta de usuário. |
Descrição | A descrição da conta de usuário. |
Senha | O hash da senha de usuário no formato apropriado para o computador Linux. Normalmente, é um hash SHA-256 ou SHA-512 com valor de sal. No Debian e no Ubuntu Linux, esse valor pode ser gerado com o comando mkpasswd . Para outras distribuições de Linux, o método de criptografia da biblioteca de Criptografia do Python pode ser usado para gerar o hash. |
Desabilitado | Indica se a conta está habilitada. Defina essa propriedade como $true para garantir que essa conta esteja desabilitada e defina-a como $false para garantir que esteja habilitada. |
PasswordChangeRequired | Indica se o usuário pode alterar a senha. Defina essa propriedade como $true para garantir que o usuário não possa alterar a senha e defina-a como $false para permitir que o usuário altere a senha. O valor padrão é $false . Essa propriedade é avaliada apenas se a conta de usuário não existia anteriormente e está sendo criada. |
HomeDirectory | O diretório inicial do usuário. |
GroupID | A ID primária de grupo do usuário. |
Propriedades comuns
Propriedade | Descrição |
---|---|
DependsOn | Indica que a configuração de outro recurso deve ser executada antes de ele ser configurado. Por exemplo, se a ID do bloco de script de configuração do recurso que você deseja executar primeiro for ResourceName e seu tipo for ResourceType, a sintaxe para usar essa propriedade será DependsOn = "[ResourceType]ResourceName" . |
Ensure | Especifica se a conta existe. Defina essa propriedade como Present para garantir que a conta exista e defina-o como Absent para garantir que a conta não exista. |
Exemplo
O exemplo a seguir garante que o usuário "monuser" exista e seja membro do grupo "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"
}
}
Colaborar conosco no GitHub
A fonte deste conteúdo pode ser encontrada no GitHub, onde você também pode criar e revisar problemas e solicitações de pull. Para obter mais informações, confira o nosso guia para colaboradores.
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de