Share via

Gruppo

  • Articolo

Riepilogo

Gestire un gruppo locale.

Sintassi

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

Descrizione

La Group risorsa consente di gestire i gruppi locali. Può creare, aggiornare e rimuovere gruppi. È possibile usare questa risorsa per applicare l'appartenenza al gruppo e impostare la descrizione del gruppo.

Requisiti

No.

Proprietà della chiave

GroupName

Specificare il nome del gruppo.

Type: System.String

Proprietà facoltative

Credenziale

Specificare le credenziali per un account con l'autorizzazione per risolvere i membri del gruppo non locali, se necessario.

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

Descrizione

Specificare la descrizione del gruppo.

Type: System.String
Default Value: None

Ensure

Specificare se il gruppo deve esistere. Per aggiungere o aggiornare un gruppo, impostare questa proprietà su Present. Per rimuovere un gruppo, impostare questa proprietà su Absent. Il valore predefinito è Present.

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

Membri

Specificare l'elenco completo dei membri del gruppo come matrice di stringhe. Se si specifica questa proprietà, la risorsa imposta l'elenco dei membri del gruppo su questo valore. Formattare ogni membro come uno dei seguenti:

  • Nome completo del dominio: <domain>\<username>
  • UPN: <username>@<domain>
  • Nome distinto: CN=<username>,DC=...
  • Nome utente: <username>

Non utilizzare questa proprietà con le proprietà MembersToExclude o MembersToInclude . In tal caso, la risorsa genera un'eccezione.

Type: System.String[]
Default Value: None

MembersToExclude

Specificare uno o più membri da escludere dal gruppo come matrice di stringhe. Se si specifica questa proprietà, la risorsa rimuove questi membri dal gruppo se li include. Formattare ogni membro come uno dei seguenti:

  • Nome completo del dominio: <domain>\<username>
  • UPN: <username>@<domain>
  • Nome distinto: CN=<username>,DC=...
  • Nome utente: <username>

Non utilizzare questa proprietà con la proprietà Members . In tal caso, la risorsa genera un'eccezione.

Type: System.String[]
Default Value: None

MembersToInclude

Specificare uno o più membri da includere nel gruppo come matrice di stringhe. Se si specifica questa proprietà, la risorsa aggiunge questi membri dal gruppo, se non li include. Formattare ogni membro come uno dei seguenti:

  • Nome completo del dominio: <domain>\<username>
  • UPN: <username>@<domain>
  • Nome distinto: CN=<username>,DC=...
  • Nome utente: <username>

Non utilizzare questa proprietà con la proprietà Members . In tal caso, la risorsa genera un'eccezione.

Type: System.String[]
Default Value: None

Esempi