Add-LocalGroupMember

  • Reference
Modul:
Microsoft.PowerShell.LocalAccounts

Přidá členy do místní skupiny.

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

Rutina Add-LocalGroupMember přidá uživatele nebo skupiny do místní skupiny zabezpečení. Všechna práva a oprávnění přiřazená ke skupině jsou přiřazena všem členům této skupiny.

Členové skupiny Správa istrators v místním počítači mají na tomto počítači oprávnění Úplné řízení. Omezte počet uživatelů ve skupině Správa istrators.

Pokud je počítač připojený k doméně, můžete do místní skupiny přidat uživatelské účty, účty počítačů a skupinové účty z této domény a z důvěryhodných domén.

Poznámka:

Pokud je počítač připojený k doméně a pokusíte se přidat místního uživatele se stejným názvem jako člen domény, který přidá člena domény.

Příklady

Příklad 1: Přidání členů do skupiny Správa istrators

Tento příkaz přidá do místní skupiny Správa istrators několik členů. Noví členové zahrnují místní uživatelský účet, účet Microsoft, účet Microsoft a skupinu domén. Tento příklad používá zástupnou hodnotu pro uživatelské jméno účtu v Outlook.com.

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

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Group

Určuje skupinu zabezpečení, do které tato rutina přidává členy.

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

-Member

Určuje pole uživatelů nebo skupin, které tato rutina přidá do skupiny zabezpečení. Uživatele nebo skupiny můžete zadat podle názvu, ID zabezpečení (SID) nebo objektů LocalPrincipal .

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

-Name

Určuje název skupiny zabezpečení, do které tato rutina přidává členy.

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

-SID

Určuje ID zabezpečení skupiny zabezpečení, do které tato rutina přidává členy.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

System.Management.Automation.SecurityAccountsManager.LocalGroup

K této rutině můžete připojit místní objekt zabezpečení.

String

Do této rutiny můžete zamísit řetězec.

SecurityIdentifier

Identifikátor SID můžete do této rutiny převést.

Výstupy

None

Tato rutina nevrátí žádný výstup.

Poznámky

Windows PowerShell obsahuje následující aliasy pro Add-LocalGroupMember:

  • algm

Modul Microsoft.PowerShell.LocalAccounts není k dispozici v 32bitovém PowerShellu v 64bitovém systému.

PrincipalSource vlastnost je vlastnost localUser, LocalGroup a LocalPrincipal objekty, které popisují zdroj objektu. Možné zdroje jsou následující:

  • Místní
  • Active Directory
  • Skupina Microsoft Entra
  • Účet Microsoft

PrincipalSource podporuje jenom Windows 10, Windows Server 2016 a novější verze operačního systému Windows. U starších verzí je tato vlastnost prázdná.