Bagikan melalui

Rename-LocalGroup

  • Referensi
Modul:
Microsoft.PowerShell.LocalAccounts

Mengganti nama grup keamanan lokal.

Sintaks

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>]

Deskripsi

Cmdlet Ganti Nama-LocalGroup mengganti nama grup keamanan lokal.

Catatan

Modul Microsoft.PowerShell.LocalAccounts tidak tersedia di PowerShell 32-bit pada sistem 64-bit.

Contoh

Contoh 1: Mengubah nama grup

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

Perintah ini mengganti nama grup keamanan bernama SecurityGroup.

Parameter

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

-InputObject

Menentukan grup keamanan yang diganti namanya cmdlet ini. Untuk mendapatkan grup keamanan, gunakan cmdlet Get-LocalGroup.

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

-Name

Menentukan nama grup keamanan yang diganti namanya cmdlet ini.

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

-NewName

Menentukan nama baru untuk grup keamanan.

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

-SID

Menentukan ID keamanan (SID) dari grup keamanan yang diganti namanya cmdlet ini.

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

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

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

Input

System.Management.Automation.SecurityAccountsManager.LocalGroup

Anda dapat menyalurkan grup keamanan ke cmdlet ini.

String

Anda dapat menyalurkan string ke cmdlet ini.

SecurityIdentifier

Anda dapat menyalurkan SID ke cmdlet ini.

Output

None

Cmdlet ini tidak mengembalikan output.

Catatan

Windows PowerShell menyertakan alias berikut untuk Rename-LocalGroup:

  • rnlg

Properti PrincipalSource adalah properti pada objek LocalUser, LocalGroup, dan LocalPrincipal yang menjelaskan sumber objek. Sumber yang mungkin adalah sebagai berikut:

  • Lokal
  • Direktori Aktif
  • Grup Microsoft Entra
  • Akun Microsoft

PrincipalSource hanya didukung oleh Windows 10, Windows Server 2016, dan versi sistem operasi Windows yang lebih baru. Untuk versi yang lebih lama, properti kosong.