Bagikan melalui

Set-LocalGroup

  • Referensi
Modul:
Microsoft.PowerShell.LocalAccounts

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

Set-LocalGroup Cmdlet 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.

Catatan

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

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

-Description

Menentukan komentar untuk grup. Panjang maksimum adalah 48 karakter.

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

-InputObject

Menentukan grup keamanan yang diubah 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 diubah cmdlet ini.

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

-SID

Menentukan ID keamanan (SID) dari grup keamanan yang diubah 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 Set-LocalGroup:

  • slg

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.