Compartir a través de

Grupo

  • Artículo

Sinopsis

Administrar un grupo local.

Sintaxis

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

Descripción

El Group recurso permite administrar grupos locales. Puede crear, actualizar y quitar grupos. Puede usar este recurso para aplicar la pertenencia a grupos y establecer la descripción del grupo.

Requisitos

Ninguno.

Propiedades de la clave

NombreDeGrupo

Especifique el nombre del grupo.

Type: System.String

Propiedades opcionales

Credential:

Especifique la credencial de una cuenta con permiso para resolver los miembros del grupo no local si es necesario.

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

Descripción

Especifique la descripción del grupo.

Type: System.String
Default Value: None

Ensure

Especifique si el grupo debe existir. Para agregar o actualizar un grupo, establezca esta propiedad en Present. Para quitar un grupo, establezca esta propiedad en Absent. El valor predeterminado es Present.

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

Miembros

Especifique la lista completa de los miembros del grupo como una matriz de cadenas. Si especifica esta propiedad, el recurso establece la lista de miembros del grupo en este valor. Dé formato a cada miembro como uno de los siguientes:

  • Nombre completo de dominio: <domain>\<username>
  • UPN: <username>@<domain>
  • Nombre distintivo: CN=<username>,DC=...
  • Nombre de usuario: <username>

No utilice esta propiedad con las propiedades MembersToExclude o MembersToInclude . Si lo hace, el recurso produce una excepción.

Type: System.String[]
Default Value: None

MembersToExclude

Especifique uno o varios miembros que se excluirán del grupo como una matriz de cadenas. Si especifica esta propiedad, el recurso quita estos miembros del grupo si los incluye. Dé formato a cada miembro como uno de los siguientes:

  • Nombre completo de dominio: <domain>\<username>
  • UPN: <username>@<domain>
  • Nombre distintivo: CN=<username>,DC=...
  • Nombre de usuario: <username>

No utilice esta propiedad con la propiedad Members . Si lo hace, el recurso produce una excepción.

Type: System.String[]
Default Value: None

MembersToInclude

Especifique uno o varios miembros que se van a incluir en el grupo como una matriz de cadenas. Si especifica esta propiedad, el recurso agrega estos miembros del grupo si no los incluye. Dé formato a cada miembro como uno de los siguientes:

  • Nombre completo de dominio: <domain>\<username>
  • UPN: <username>@<domain>
  • Nombre distintivo: CN=<username>,DC=...
  • Nombre de usuario: <username>

No utilice esta propiedad con la propiedad Members . Si lo hace, el recurso produce una excepción.

Type: System.String[]
Default Value: None

Ejemplos