Gruppo
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
