Group

  • Artikel

Übersicht

Verwalten einer lokalen Gruppe

Syntax

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

BESCHREIBUNG

Mit der Group Ressource können Sie lokale Gruppen verwalten. Sie kann Gruppen erstellen, aktualisieren und entfernen. Sie können diese Ressource verwenden, um die Gruppenmitgliedschaft zu erzwingen und die Beschreibung der Gruppe festzulegen.

Requirements (Anforderungen)

Keine

Schlüsseleigenschaften

GroupName

Geben Sie den Namen der Gruppe an.

Type: System.String

Optionale Eigenschaften

Anmeldeinformationen

Geben Sie bei Bedarf die Anmeldeinformationen für ein Konto mit der Berechtigung an, nicht lokale Gruppenmitglieder aufzulösen.

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

Beschreibung

Geben Sie die Beschreibung der Gruppe an.

Type: System.String
Default Value: None

Ensure

Geben Sie an, ob die Gruppe vorhanden sein soll. Um eine Gruppe hinzuzufügen oder zu aktualisieren, legen Sie diese Eigenschaft auf Present. Um eine Gruppe zu entfernen, legen Sie diese Eigenschaft auf Absent. Standardwert: Present.

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

Members

Geben Sie die vollständige Liste der Mitglieder der Gruppe als Array von Zeichenfolgen an. Wenn Sie diese Eigenschaft angeben, legt die Ressource die Mitgliederliste der Gruppe auf diesen Wert fest. Formatieren Sie jedes Element als eines der folgenden:

  • Domänenqualifizierter Name: <domain>\<username>
  • UPN: <username>@<domain>
  • Unterschiedener Name: CN=<username>,DC=...
  • Benutzername: <username>

Verwenden Sie diese Eigenschaft nicht mit den MembersToExclude- oder MembersToInclude-Eigenschaften. Wenn Sie dies tun, löst die Ressource eine Ausnahme aus.

Type: System.String[]
Default Value: None

MembersToExclude

Geben Sie mindestens ein Element an, das als Array von Zeichenfolgen aus der Gruppe ausgeschlossen werden soll. Wenn Sie diese Eigenschaft angeben, entfernt die Ressource diese Mitglieder aus der Gruppe, wenn sie sie enthält. Formatieren Sie jedes Element als eines der folgenden:

  • Domänenqualifizierter Name: <domain>\<username>
  • UPN: <username>@<domain>
  • Unterschiedener Name: CN=<username>,DC=...
  • Benutzername: <username>

Verwenden Sie diese Eigenschaft nicht mit der Members-Eigenschaft . Wenn Sie dies tun, löst die Ressource eine Ausnahme aus.

Type: System.String[]
Default Value: None

MembersToInclude

Geben Sie mindestens ein Element an, das als Array von Zeichenfolgen in die Gruppe aufgenommen werden soll. Wenn Sie diese Eigenschaft angeben, fügt die Ressource diese Mitglieder aus der Gruppe hinzu, wenn sie sie nicht enthält. Formatieren Sie jedes Element als eines der folgenden:

  • Domänenqualifizierter Name: <domain>\<username>
  • UPN: <username>@<domain>
  • Unterschiedener Name: CN=<username>,DC=...
  • Benutzername: <username>

Verwenden Sie diese Eigenschaft nicht mit der Members-Eigenschaft . Wenn Sie dies tun, löst die Ressource eine Ausnahme aus.

Type: System.String[]
Default Value: None

Beispiele