Groupe

  • Article

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

Exemples