Group

  • Artikel

Synopsis

Hantera en lokal grupp.

Syntax

Group [String] #ResourceName
{
    GroupName = [string]
    [Credential = [PSCredential]]
    [DependsOn = [string[]]]
    [Description = [string]]
    [Ensure = [string]{ Absent | Present }]
    [Members = [string[]]]
    [MembersToExclude = [string[]]]
    [MembersToInclude = [string[]]]
    [PsDscRunAsCredential = [PSCredential]]
}

Description

Med resursen Group kan du hantera lokala grupper. Den kan skapa, uppdatera och ta bort grupper. Du kan använda den här resursen för att framtvinga gruppmedlemskap och ange gruppens beskrivning.

Krav

Inga.

Nyckelegenskaper

Gruppnamn

Ange namnet på gruppen.

Type: System.String

Valfria egenskaper

Autentiseringsuppgift

Ange autentiseringsuppgifter för ett konto med behörighet att matcha icke-lokala gruppmedlemmar om det behövs.

Type: System.Management.Automation.PSCredential
Default Value: None

Description

Ange gruppens beskrivning.

Type: System.String
Default Value: None

Säkerställa

Ange om gruppen ska finnas. Om du vill lägga till eller uppdatera en grupp anger du den här egenskapen till Present. Om du vill ta bort en grupp anger du den här egenskapen till Absent. Standardvärdet är Present.

Type: System.String
Accepted Values:
  - Absent
  - Present
Default Value: Present

Medlemmar

Ange den fullständiga listan över gruppens medlemmar som en matris med strängar. Om du anger den här egenskapen anger resursen gruppens medlemslista till det här värdet. Formatera varje medlem som något av följande:

  • Domännamn: <domain>\<username>
  • UPN: <username>@<domain>
  • Unikt namn: CN=<username>,DC=...
  • Användarnamn: <username>

Använd inte den här egenskapen med egenskaperna MembersToExclude eller MembersToInclude . Om du gör det utlöser resursen ett undantag.

Type: System.String[]
Default Value: None

MembersToExclude

Ange en eller flera medlemmar som ska undantas från gruppen som en matris med strängar. Om du anger den här egenskapen tar resursen bort dessa medlemmar från gruppen om den innehåller dem. Formatera varje medlem som något av följande:

  • Domännamn: <domain>\<username>
  • UPN: <username>@<domain>
  • Unikt namn: CN=<username>,DC=...
  • Användarnamn: <username>

Använd inte den här egenskapen med egenskapen Medlemmar . Om du gör det utlöser resursen ett undantag.

Type: System.String[]
Default Value: None

MembersToInclude

Ange en eller flera medlemmar som ska ingå i gruppen som en matris med strängar. Om du anger den här egenskapen lägger resursen till dessa medlemmar från gruppen om den inte innehåller dem. Formatera varje medlem som något av följande:

  • Domännamn: <domain>\<username>
  • UPN: <username>@<domain>
  • Unikt namn: CN=<username>,DC=...
  • Användarnamn: <username>

Använd inte den här egenskapen med egenskapen Medlemmar . Om du gör det utlöser resursen ett undantag.

Type: System.String[]
Default Value: None

Exempel