Groupe
Synopsis
Gérer un groupe local.
Syntaxe
Group [String] #ResourceName
{
GroupName = [string]
[Credential = [PSCredential]]
[DependsOn = [string[]]]
[Description = [string]]
[Ensure = [string]{ Absent | Present }]
[Members = [string[]]]
[MembersToExclude = [string[]]]
[MembersToInclude = [string[]]]
[PsDscRunAsCredential = [PSCredential]]
}
Description
La Group ressource vous permet de gérer des groupes locaux. Il peut créer, mettre à jour et supprimer des groupes.
Vous pouvez utiliser cette ressource pour appliquer l’appartenance au groupe et définir la description du groupe.
Configuration requise
Aucun.
Propriétés de la clé
GroupName
Spécifiez le nom du groupe.
Type: System.String
Propriétés facultatives
Informations d'identification
Spécifiez les informations d’identification d’un compte avec l’autorisation de résoudre les membres de groupe non locaux si nécessaire.
Type: System.Management.Automation.PSCredential
Default Value: None
Description
Spécifiez la description du groupe.
Type: System.String
Default Value: None
Ensure
Spécifiez si le groupe doit exister. Pour ajouter ou mettre à jour un groupe, définissez cette propriété Presentsur . Pour supprimer un groupe, définissez cette propriété Absentsur . La valeur par défaut est Present.
Type: System.String
Accepted Values:
- Absent
- Present
Default Value: Present
Membres
Spécifiez la liste complète des membres du groupe sous la forme d’un tableau de chaînes. Si vous spécifiez cette propriété, la ressource définit la liste de membres du groupe sur cette valeur. Mettez en forme chaque membre comme l’un des éléments suivants :
- Nom qualifié de domaine :
<domain>\<username> - UPN:
<username>@<domain> - Nom unique :
CN=<username>,DC=... - Nom d’utilisateur :
<username>
N’utilisez pas cette propriété avec les propriétés MembersToExclude ou MembersToInclude . Si vous le faites, la ressource lève une exception.
Type: System.String[]
Default Value: None
MembersToExclude
Spécifiez un ou plusieurs membres à exclure du groupe en tant que tableau de chaînes. Si vous spécifiez cette propriété, la ressource supprime ces membres du groupe s’il les inclut. Mettez en forme chaque membre comme l’un des éléments suivants :
- Nom qualifié de domaine :
<domain>\<username> - UPN:
<username>@<domain> - Nom unique :
CN=<username>,DC=... - Nom d’utilisateur :
<username>
N’utilisez pas cette propriété avec la propriété Members . Si vous le faites, la ressource lève une exception.
Type: System.String[]
Default Value: None
MembersToInclude
Spécifiez un ou plusieurs membres à inclure dans le groupe en tant que tableau de chaînes. Si vous spécifiez cette propriété, la ressource ajoute ces membres du groupe s’il ne les inclut pas. Mettez en forme chaque membre comme l’un des éléments suivants :
- Nom qualifié de domaine :
<domain>\<username> - UPN:
<username>@<domain> - Nom unique :
CN=<username>,DC=... - Nom d’utilisateur :
<username>
N’utilisez pas cette propriété avec la propriété Members . Si vous le faites, la ressource lève une exception.
Type: System.String[]
Default Value: None
