Group
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
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för