Bagikan melalui

Add-LocalGroupMember

  • Referensi
Modul:
Microsoft.PowerShell.LocalAccounts

Menambahkan anggota ke grup lokal.

Sintaks

Add-LocalGroupMember
   [-Group] <LocalGroup>
   [-Member] <LocalPrincipal[]>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-LocalGroupMember
   [-Member] <LocalPrincipal[]>
   [-Name] <String>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-LocalGroupMember
   [-Member] <LocalPrincipal[]>
   [-SID] <SecurityIdentifier>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Deskripsi

Add-LocalGroupMember Cmdlet menambahkan pengguna atau grup ke grup keamanan lokal. Semua hak dan izin yang ditetapkan ke grup ditetapkan ke semua anggota grup tersebut.

Anggota grup Administrator pada komputer lokal memiliki izin Kontrol Penuh pada komputer tersebut. Batasi jumlah pengguna dalam grup Administrator.

Jika komputer bergabung ke domain, Anda bisa menambahkan akun pengguna, akun komputer, dan akun grup dari domain tersebut dan dari domain tepercaya ke grup lokal.

Catatan

Jika komputer bergabung ke domain dan Anda mencoba menambahkan pengguna lokal yang memiliki nama yang sama dengan anggota domain, ia menambahkan anggota domain.

Contoh

Contoh 1: Menambahkan anggota ke grup Administrator

Perintah ini menambahkan beberapa anggota ke grup Administrator lokal. Anggota baru menyertakan akun pengguna lokal, akun Microsoft, akun Microsoft Entra, dan grup domain. Contoh ini menggunakan nilai tempat penampung untuk nama pengguna akun di Outlook.com.

Add-LocalGroupMember -Group "Administrators" -Member "Admin02", "MicrosoftAccount\username@Outlook.com", "AzureAD\DavidChew@contoso.com", "CONTOSO\Domain Admins"

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

-Group

Menentukan grup keamanan tempat cmdlet ini menambahkan anggota.

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

-Member

Menentukan array pengguna atau grup yang ditambahkan cmdlet ini ke grup keamanan. Anda dapat menentukan pengguna atau grup berdasarkan nama, ID keamanan (SID), atau objek LocalPrincipal .

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

-Name

Menentukan nama grup keamanan tempat cmdlet ini menambahkan anggota.

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

-SID

Menentukan ID keamanan grup keamanan tempat cmdlet ini menambahkan anggota.

Type:SecurityIdentifier
Position:0
Default value:None
Required:True
Accept pipeline input:False
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 perwakilan lokal 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 Add-LocalGroupMember:

  • algm

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

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.