Share via

New-LocalGroup

  • Referencia
Módulo:
Microsoft.PowerShell.LocalAccounts

Crea un grupo de seguridad local.

Syntax

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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.