Bagikan melalui

Remove-LocalGroup

  • Referensi
Modul:
Microsoft.PowerShell.LocalAccounts

Menghapus grup keamanan lokal.

Sintaks

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

Deskripsi

Remove-LocalGroup Cmdlet menghapus grup keamanan lokal. Cmdlet ini hanya menghapus grup lokal. Ini tidak menghapus akun pengguna, akun komputer, atau akun grup yang termasuk dalam grup tersebut. Anda tidak dapat memulihkan grup yang dihapus.

Jika Anda menghapus grup lalu membuat grup lain yang memiliki nama grup yang sama, Anda harus mengatur izin baru untuk grup baru. Grup baru tidak mewarisi izin yang ditetapkan ke grup.

Catatan

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

Contoh

Contoh 1: Menghapus grup keamanan

Remove-LocalGroup -Name "SecurityGroup04"

Perintah ini menghapus grup bernama SecurityGroup04.

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 array grup keamanan yang dihapus cmdlet ini. Untuk mendapatkan grup, gunakan Get-LocalGroup cmdlet .

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

-Name

Menentukan array nama grup keamanan yang dihapus cmdlet ini.

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

-SID

Menentukan array ID keamanan (SID) grup keamanan yang dihapus 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 Remove-LocalGroup:

  • rlg

Cmdlet ini tidak dapat menghapus grup default berikut:

  • Administrator
  • Operator Azure Backup
  • Operator Kriptografi
  • Pengguna COM Terdistribusi
  • Pembaca Log Peristiwa
  • Tamu
  • Administrator Hyper-V
  • IIS_IUSRS
  • Operator Konfigurasi Jaringan
  • Pengguna Log Performa
  • Pengguna Pemantau Performa
  • Pengguna Power
  • Pengguna Desktop Jarak Jauh
  • Pengguna Manajemen Jarak Jauh
  • Replikator
  • Pengguna
  • WinRMRemoteWMIUsers__

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.