Group (Skupina)

Synopse

Správa místní skupiny

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

Prostředek Group umožňuje spravovat místní skupiny. Může vytvářet, aktualizovat a odebírat skupiny. Tento prostředek můžete použít k vynucení členství ve skupině a nastavení popisu skupiny.

Požadavky

Žádné

Základní vlastnosti

Groupname

Zadejte název skupiny.

Type: System.String

Volitelné vlastnosti

Přihlašovací údaj

V případě potřeby zadejte přihlašovací údaje pro účet s oprávněním k překladu členů jiné než místní skupiny.

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

Description

Zadejte popis skupiny.

Type: System.String
Default Value: None

Zajištění

Určete, jestli má skupina existovat. Chcete-li přidat nebo aktualizovat skupinu, nastavte tuto vlastnost na Present. Chcete-li odebrat skupinu, nastavte tuto vlastnost na Absent. Výchozí hodnota je Present.

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

Členové

Zadejte úplný seznam členů skupiny jako pole řetězců. Pokud tuto vlastnost zadáte, prostředek nastaví seznam členů skupiny na tuto hodnotu. Naformátujte každý člen jedním z následujících způsobů:

  • Kvalifikovaný název domény: <domain>\<username>
  • UPN: <username>@<domain>
  • Rozlišující název: CN=<username>,DC=...
  • Uživatelské jméno: <username>

Nepoužívejte tuto vlastnost s vlastnostmi MembersToExclude nebo MembersToInclude . Pokud ano, prostředek vyvolá výjimku.

Type: System.String[]
Default Value: None

MembersToExclude

Zadejte jeden nebo více členů, které chcete ze skupiny vyloučit jako pole řetězců. Pokud tuto vlastnost zadáte, prostředek odebere tyto členy ze skupiny, pokud je obsahuje. Naformátujte každý člen jedním z následujících způsobů:

  • Kvalifikovaný název domény: <domain>\<username>
  • UPN: <username>@<domain>
  • Rozlišující název: CN=<username>,DC=...
  • Uživatelské jméno: <username>

Tuto vlastnost nepoužívejte s vlastností Členové . Pokud ano, prostředek vyvolá výjimku.

Type: System.String[]
Default Value: None

MembersToInclude

Zadejte jeden nebo více členů, které se mají zahrnout do skupiny jako pole řetězců. Pokud tuto vlastnost zadáte, prostředek přidá tyto členy ze skupiny, pokud je neobsahuje. Naformátujte každý člen jedním z následujících způsobů:

  • Kvalifikovaný název domény: <domain>\<username>
  • UPN: <username>@<domain>
  • Rozlišující název: CN=<username>,DC=...
  • Uživatelské jméno: <username>

Tuto vlastnost nepoužívejte s vlastností Členové . Pokud ano, prostředek vyvolá výjimku.

Type: System.String[]
Default Value: None

Příklady