Group (Grupa)

  • Artykuł

Streszczenie

Zarządzanie grupą lokalną.

Składnia

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

Opis

Zasób Group umożliwia zarządzanie grupami lokalnymi. Może tworzyć, aktualizować i usuwać grupy. Za pomocą tego zasobu można wymusić członkostwo w grupie i ustawić opis grupy.

Wymagania

Brak.

Kluczowe właściwości

Groupname

Określ nazwę grupy.

Type: System.String

Właściwości opcjonalne

Poświadczenie

Określ poświadczenie konta z uprawnieniem do rozpoznawania nielokalnych członków grupy w razie potrzeby.

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

Opis

Określ opis grupy.

Type: System.String
Default Value: None

Zapewnienia

Określ, czy grupa powinna istnieć. Aby dodać lub zaktualizować grupę, ustaw tę właściwość na Present. Aby usunąć grupę, ustaw tę właściwość na Absent. Wartość domyślna to Present.

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

Elementy członkowskie

Określ pełną listę członków grupy jako tablicę ciągów. Jeśli określisz tę właściwość, zasób ustawia listę członków grupy na tę wartość. Formatuj każdy element członkowski jako jeden z następujących elementów:

  • Nazwa kwalifikowana domeny: <domain>\<username>
  • UPN: <username>@<domain>
  • Nazwa wyróżniająca: CN=<username>,DC=...
  • Nazwa użytkownika: <username>

Nie używaj tej właściwości z właściwościami MembersToExclude lub MembersToInclude . Jeśli to zrobisz, zasób zgłasza wyjątek.

Type: System.String[]
Default Value: None

CzłonkowieToExclude

Określ co najmniej jeden element członkowny do wykluczenia z grupy jako tablicę ciągów. Jeśli określisz tę właściwość, zasób usunie tych członków z grupy, jeśli je uwzględni. Formatuj każdy element członkowski jako jeden z następujących elementów:

  • Nazwa kwalifikowana domeny: <domain>\<username>
  • UPN: <username>@<domain>
  • Nazwa wyróżniająca: CN=<username>,DC=...
  • Nazwa użytkownika: <username>

Nie używaj tej właściwości z właściwością Członkowie . Jeśli to zrobisz, zasób zgłasza wyjątek.

Type: System.String[]
Default Value: None

CzłonkowieToInclude

Określ co najmniej jeden element członkowny do uwzględnienia w grupie jako tablicę ciągów. Jeśli określisz tę właściwość, zasób doda tych członków z grupy, jeśli nie zostanie on uwzględniny. Formatuj każdy element członkowski jako jeden z następujących elementów:

  • Nazwa kwalifikowana domeny: <domain>\<username>
  • UPN: <username>@<domain>
  • Nazwa wyróżniająca: CN=<username>,DC=...
  • Nazwa użytkownika: <username>

Nie używaj tej właściwości z właściwością Członkowie . Jeśli to zrobisz, zasób zgłasza wyjątek.

Type: System.String[]
Default Value: None

Przykłady