Compartir a través de

Rename-LocalGroup

  • Referencia
Módulo:
Microsoft.PowerShell.LocalAccounts

Cambia el nombre de un grupo de seguridad local.

Syntax

Rename-LocalGroup
      [-InputObject] <LocalGroup>
      [-NewName] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Rename-LocalGroup
      [-Name] <String>
      [-NewName] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Rename-LocalGroup
      [-NewName] <String>
      [-SID] <SecurityIdentifier>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El cmdlet Rename-LocalGroup cambia el nombre de un grupo de seguridad local.

Nota:

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

Ejemplos

Ejemplo 1: Cambiar el nombre de un grupo

PS C:\> Rename-LocalGroup -Name "SecurityGroup" -NewName "SecurityGroup04"

Este comando cambia el nombre de un grupo de seguridad denominado SecurityGroup.

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

-InputObject

Especifica el grupo de seguridad al que cambia el nombre de este cmdlet. Para obtener un grupo de seguridad, use el cmdlet Get-LocalGroup.

Type:Microsoft.PowerShell.Commands.LocalGroup
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifica el nombre del grupo de seguridad al que cambia el nombre de este cmdlet.

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

-NewName

Especifica un nuevo nombre para el grupo de seguridad.

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

-SID

Especifica el identificador de seguridad (SID) de un grupo de seguridad al que cambia el nombre de este cmdlet.

Type:SecurityIdentifier
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

System.Management.Automation.SecurityAccountsManager.LocalGroup

Puede canalizar un grupo de seguridad a este cmdlet.

String

Puede canalizar una cadena a este cmdlet.

SecurityIdentifier

Puede canalizar un SID a este cmdlet.

Salidas

None

Este cmdlet no devuelve ningún resultado.

Notas

Windows PowerShell incluye los siguientes alias para Rename-LocalGroup:

  • rnlg

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
  • Grupo de Microsoft Entra
  • Cuenta Microsoft

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.