Add-LocalGroupMember
Lägger till medlemmar i en lokal grupp.
Syntax
Group
Add-LocalGroupMember
[-Group] <LocalGroup>
[-Member] <LocalPrincipal[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Add-LocalGroupMember
[-Member] <LocalPrincipal[]>
[-Name] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SecurityIdentifier
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.
Anmärkning
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.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | jfr |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Group
Anger den säkerhetsgrupp som den här cmdleten lägger till medlemmar i.
Parameteregenskaper
| Typ: | Microsoft.PowerShell.Commands.LocalGroup |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
Group
| Position: | 0 |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | 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.
Parameteregenskaper
| Typ: | Microsoft.PowerShell.Commands.LocalPrincipal[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | 1 |
| Obligatorisk: | True |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-Name
Anger namnet på säkerhetsgruppen som den här cmdleten lägger till medlemmar i.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
Default
| Position: | 0 |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-SID
Anger säkerhets-ID för säkerhetsgruppen som den här cmdleten lägger till medlemmar i.
Parameteregenskaper
| Typ: | SecurityIdentifier |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
SecurityIdentifier
| Position: | 0 |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-WhatIf
Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | Wi |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
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 på LocalUser, LocalGroupoch 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.
