Dela via

Rename-LocalGroup

  • Referens
Modul:
Microsoft.PowerShell.LocalAccounts

Byter namn på en lokal säkerhetsgrupp.

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

Cmdleten Rename-LocalGroup byter namn på en lokal säkerhetsgrupp.

Not

Modulen Microsoft.PowerShell.LocalAccounts är inte tillgänglig i 32-bitars PowerShell i ett 64-bitarssystem.

Exempel

Exempel 1: Ändra namnet på en grupp

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

Det här kommandot byter namn på en säkerhetsgrupp med namnet SecurityGroup.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InputObject

Anger den säkerhetsgrupp som den här cmdleten byter namn på. Om du vill hämta en säkerhetsgrupp använder du cmdleten Get-LocalGroup.

Typ:Microsoft.PowerShell.Commands.LocalGroup
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Anger namnet på säkerhetsgruppen som den här cmdleten byter namn på.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-NewName

Anger ett nytt namn för säkerhetsgruppen.

Typ:String
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SID

Anger säkerhets-ID (SID) för en säkerhetsgrupp som den här cmdleten byter namn på.

Typ:SecurityIdentifier
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

System.Management.Automation.SecurityAccountsManager.LocalGroup

Du kan skicka en säkerhetsgrupp till den här cmdleten.

String

Du kan skicka en sträng till den här cmdleten.

SecurityIdentifier

Du kan skicka ett SID till den här cmdleten.

Utdata

None

Den här cmdleten returnerar inga utdata.

Kommentarer

Windows PowerShell innehåller följande alias för Rename-LocalGroup:

  • rnlg

Egenskapen PrincipalSource är en egenskap på LocalUser, LocalGroupoch LocalPrincipal objekt som beskriver objektets källa. Möjliga källor är följande:

  • Lokal
  • Active Directory
  • Microsoft Entra-grupp
  • Microsoft-konto

PrincipalSource stöds endast av Windows 10, Windows Server 2016 och senare versioner av Windows-operativsystemet. För tidigare versioner är egenskapen tom.