Compartir a través de

New-LocalGroup

  • Referencia
Módulo:
Microsoft.PowerShell.LocalAccounts

Crea un grupo de seguridad local.

Sintaxis

New-LocalGroup
   [-Description <String>]
   [-Name] <String>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El New-LocalGroup cmdlet crea un grupo de seguridad local en el Administrador de cuentas de seguridad.

Nota:

El módulo Microsoft.PowerShell.LocalAccounts no está disponible en PowerShell de 32 bits en un sistema de 64 bits.

Ejemplos

Ejemplo 1: Creación de un grupo de seguridad

New-LocalGroup -Name "SecurityGroup04"

Este comando crea un grupo denominado SecurityGroup04.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Description

Especifica un comentario para el grupo. La longitud máxima es de 48 caracteres.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

Especifica un nombre para el grupo. La longitud máxima es de 256 caracteres.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

Puede canalizar una cadena a este cmdlet.

Salidas

System.Management.Automation.SecurityAccountsManager.LocalGroup

Este cmdlet devuelve un objeto LocalGroup que representa el grupo de seguridad creado.

Notas

Windows PowerShell incluye los siguientes alias para New-LocalGroup:

  • nlg

La propiedad PrincipalSource es una propiedad en objetos LocalUser, LocalGroup y LocalPrincipal que describen el origen del objeto. Los orígenes posibles son los siguientes:

  • Local
  • Active Directory
  • AzureAD
  • MicrosoftAccount

PrincipalSource solo es compatible con Windows 10, Windows Server 2016 y versiones posteriores del sistema operativo Windows. Para versiones anteriores, la propiedad está en blanco.