Agrupar
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
