Sdílet prostřednictvím

Rename-LocalGroup

  • Reference
Modul:
Microsoft.PowerShell.LocalAccounts

Přejmenuje místní skupinu zabezpečení.

Syntaxe

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

Rutina Rename-LocalGroup přejmenuje místní skupinu zabezpečení.

Poznámka:

Modul Microsoft.PowerShell.LocalAccounts není k dispozici v 32bitovém PowerShellu v 64bitovém systému.

Příklady

Příklad 1: Změna názvu skupiny

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

Tento příkaz přejmenuje skupinu zabezpečení s názvem SecurityGroup.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InputObject

Určuje skupinu zabezpečení, kterou tato rutina přejmenuje. K získání skupiny zabezpečení použijte rutinu Get-LocalGroup.

Typ:Microsoft.PowerShell.Commands.LocalGroup
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Určuje název skupiny zabezpečení, kterou tato rutina přejmenuje.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-NewName

Určuje nový název skupiny zabezpečení.

Typ:String
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SID

Určuje ID zabezpečení (SID) skupiny zabezpečení, kterou tato rutina přejmenuje.

Typ:SecurityIdentifier
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

System.Management.Automation.SecurityAccountsManager.LocalGroup

Do této rutiny můžete převést skupinu zabezpečení.

String

Do této rutiny můžete zamísit řetězec.

SecurityIdentifier

Identifikátor SID můžete do této rutiny převést.

Výstupy

None

Tato rutina nevrátí žádný výstup.

Poznámky

Windows PowerShell obsahuje následující aliasy pro Rename-LocalGroup:

  • rnlg

PrincipalSource vlastnost je vlastnost localUser, LocalGroup a LocalPrincipal objekty, které popisují zdroj objektu. Možné zdroje jsou následující:

  • Místní
  • Active Directory
  • Skupina Microsoft Entra
  • Účet Microsoft

PrincipalSource podporuje jenom Windows 10, Windows Server 2016 a novější verze operačního systému Windows. U starších verzí je tato vlastnost prázdná.