Share via

Agrupar

  • Artigo

Sinopse

Gerenciar um grupo local.

Sintaxe

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

Descrição

O Group recurso permite que você gerencie grupos locais. Ele pode criar, atualizar e remover grupos. Você pode usar esse recurso para impor a associação de grupo e definir a descrição do grupo.

Requisitos

Nenhum.

Propriedades da chave

GroupName

Especifique o nome do grupo.

Type: System.String

Propriedades opcionais

Credencial

Especifique a credencial de uma conta com permissão para resolver membros de grupo não locais, se necessário.

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

Descrição

Especifique a descrição do grupo.

Type: System.String
Default Value: None

Ensure

Especifique se o grupo deve existir. Para adicionar ou atualizar um grupo, defina essa propriedade como Present. Para remover um grupo, defina essa propriedade como Absent. O valor padrão é Present.

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

Membros

Especifique a lista completa dos membros do grupo como uma matriz de cadeias de caracteres. Se você especificar essa propriedade, o recurso definirá a lista de membros do grupo como esse valor. Formate cada membro como um dos seguintes:

  • Nome qualificado do domínio: <domain>\<username>
  • UPN: <username>@<domain>
  • Nome diferenciado: CN=<username>,DC=...
  • Username: <username>

Não use essa propriedade com as propriedades MembersToExclude ou MembersToInclude . Se você fizer isso, o recurso gerará uma exceção.

Type: System.String[]
Default Value: None

MembersToExclude

Especifique um ou mais membros a serem excluídos do grupo como uma matriz de cadeias de caracteres. Se você especificar essa propriedade, o recurso removerá esses membros do grupo se ele os incluir. Formate cada membro como um dos seguintes:

  • Nome qualificado do domínio: <domain>\<username>
  • UPN: <username>@<domain>
  • Nome diferenciado: CN=<username>,DC=...
  • Username: <username>

Não use essa propriedade com a propriedade Members . Se você fizer isso, o recurso gerará uma exceção.

Type: System.String[]
Default Value: None

MembersToInclude

Especifique um ou mais membros a serem incluídos no grupo como uma matriz de cadeias de caracteres. Se você especificar essa propriedade, o recurso adicionará esses membros do grupo se ele não os incluir. Formate cada membro como um dos seguintes:

  • Nome qualificado do domínio: <domain>\<username>
  • UPN: <username>@<domain>
  • Nome diferenciado: CN=<username>,DC=...
  • Username: <username>

Não use essa propriedade com a propriedade Members . Se você fizer isso, o recurso gerará uma exceção.

Type: System.String[]
Default Value: None

Exemplos