Remove-LocalGroup
Menghapus grup keamanan lokal.
Sintaks
InputObject
Remove-LocalGroup
[-InputObject] <LocalGroup[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Remove-LocalGroup
[-Name] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SecurityIdentifier
Remove-LocalGroup
[-SID] <SecurityIdentifier[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
Cmdlet Remove-LocalGroup 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.
Nota
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 konfirmasi sebelum menjalankan cmdlet.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | Cf |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-InputObject
Menentukan array grup keamanan yang dihapus cmdlet ini. Untuk mendapatkan grup, gunakan cmdlet Get-LocalGroup.
Properti parameter
| Jenis: | Microsoft.PowerShell.Commands.LocalGroup[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
InputObject
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-Name
Menentukan array nama grup keamanan yang dihapus cmdlet ini.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
Default
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-SID
Menentukan array ID keamanan (SID) grup keamanan yang dihapus cmdlet ini.
Properti parameter
| Jenis: | |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
SecurityIdentifier
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-WhatIf
Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | wi |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.
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:
- Administrators
- Operator Pencadangan
- Operator Kriptografi
- Pengguna COM Terdistribusi
- Pembaca Catatan Kejadian
- Para tamu
- Administrator Hyper-V
- IIS_IUSRS
- Operator Konfigurasi Jaringan
- Pengguna Log Kinerja
- Pengguna Pemantau Kinerja
- Pengguna Daya
- Pengguna Desktop Jarak Jauh
- Pengguna Manajemen Jarak Jauh
- Replikator
- Pengguna
- WinRMRemoteWMIUsers__
Properti PrincipalSource adalah properti pada objek LocalUser, LocalGroup, dan LocalPrincipal yang menggambarkan sumber dari objek tersebut. Sumber yang mungkin adalah sebagai berikut:
- Lokal
- Active Directory
- 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, atributnya kosong.