Dela via

Add-LocalGroupMember

  • Referens
Modul:
Microsoft.PowerShell.LocalAccounts

Lägger till medlemmar i en lokal grupp.

Syntax

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>]

Description

Cmdleten Add-LocalGroupMember lägger till användare eller grupper i en lokal säkerhetsgrupp. Alla rättigheter och behörigheter som har tilldelats till en grupp tilldelas till alla medlemmar i den gruppen.

Medlemmar i gruppen Administratörer på en lokal dator har fullständig behörighet på datorn. Begränsa antalet användare i gruppen Administratörer.

Om datorn är ansluten till en domän kan du lägga till användarkonton, datorkonton och gruppkonton från den domänen och från betrodda domäner till en lokal grupp.

Kommentar

Om datorn är ansluten till en domän och du försöker lägga till en lokal användare som har samma namn som en medlem i domänen lägger den till domänmedlemmen.

Exempel

Exempel 1: Lägga till medlemmar i gruppen Administratörer

Det här kommandot lägger till flera medlemmar i den lokala gruppen Administratörer. De nya medlemmarna innehåller ett lokalt användarkonto, ett Microsoft-konto, ett Microsoft Entra-konto och en domängrupp. I det här exemplet används ett platshållarvärde för användarnamnet för ett konto på Outlook.com.

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

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Group

Anger den säkerhetsgrupp som den här cmdleten lägger till medlemmar i.

Typ:Microsoft.PowerShell.Commands.LocalGroup
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Member

Anger en matris med användare eller grupper som den här cmdleten lägger till i en säkerhetsgrupp. Du kan ange användare eller grupper efter namn, säkerhets-ID (SID) eller LocalPrincipal-objekt .

Typ:Microsoft.PowerShell.Commands.LocalPrincipal[]
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Anger namnet på säkerhetsgruppen som den här cmdleten lägger till medlemmar i.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SID

Anger säkerhets-ID för säkerhetsgruppen som den här cmdleten lägger till medlemmar i.

Typ:SecurityIdentifier
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

System.Management.Automation.SecurityAccountsManager.LocalGroup

Du kan skicka ett lokalt huvudnamn till den här cmdleten.

String

Du kan skicka en sträng till den här cmdleten.

SecurityIdentifier

Du kan skicka ett SID till den här cmdleten.

Utdata

None

Den här cmdleten returnerar inga utdata.

Kommentarer

Windows PowerShell innehåller följande alias för Add-LocalGroupMember:

  • algm

Modulen Microsoft.PowerShell.LocalAccounts är inte tillgänglig i 32-bitars PowerShell i ett 64-bitarssystem.

Egenskapen PrincipalSource är en egenskap för LocalUser-, LocalGroup- och LocalPrincipal-objekt som beskriver objektets källa. Möjliga källor är följande:

  • Lokal
  • Active Directory
  • Microsoft Entra-grupp
  • Microsoft-konto

PrincipalSource stöds endast av Windows 10, Windows Server 2016 och senare versioner av Windows-operativsystemet. För tidigare versioner är egenskapen tom.