Bagikan melalui


Set-LocalGroup

Mengubah grup keamanan lokal.

Sintaks

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

Deskripsi

Cmdlet Set-LocalGroup mengubah grup keamanan lokal.

Contoh

Contoh 1: Mengubah deskripsi grup

Set-LocalGroup -Name "SecurityGroup04" -Description "This is a sample description."

Perintah ini mengubah deskripsi grup lokal.

Nota

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

Parameter

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Jenis:SwitchParameter
Alias:cf
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Description

Menentukan komentar untuk grup. Panjang maksimum adalah 48 karakter.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-InputObject

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

Jenis:Microsoft.PowerShell.Commands.LocalGroup
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Name

Menentukan nama grup keamanan yang diubah cmdlet ini.

Jenis:String
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-SID

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

Jenis:SecurityIdentifier
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-WhatIf

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

Jenis:SwitchParameter
Alias:wi
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard: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 Set-LocalGroup:

  • slg

Properti PrincipalSource adalah properti pada localUser, LocalGroup, dan objek 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.