Sdílet prostřednictvím

New-LocalGroup

  • Reference
Modul:
Microsoft.PowerShell.LocalAccounts

Vytvoří místní skupinu zabezpečení.

Syntaxe

New-LocalGroup
   [-Description <String>]
   [-Name] <String>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Cmdlet New-LocalGroup vytvoří místní bezpečnostní skupinu ve Správci bezpečnostních účtů.

Poznámka

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

Příklady

Příklad 1: Vytvoření skupiny zabezpečení

New-LocalGroup -Name "SecurityGroup04"

Tento příkaz vytvoří skupinu s názvem SecurityGroup04.

Parametry

-Confirm

Před spuštěním rutiny cmdlet vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Description

Určuje komentář pro skupinu. Maximální délka je 256 znaků.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Určuje název skupiny. Maximální délka je 48 znaků.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se cmdlet spustí. Cmdlet se nespustil.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

Do tohoto příkazletu můžete přesměrovat řetězec.

Výstupy

System.Management.Automation.SecurityAccountsManager.LocalGroup

Tato rutina vrátí objekt LocalGroup představující vytvořenou skupinu zabezpečení.

Poznámky

Windows PowerShell obsahuje následující aliasy pro New-LocalGroup:

  • nlg

Vlastnost PrincipalSource je vlastnost objektů LocalUser, LocalGroupa LocalPrincipal, která popisuje zdroj objektu. Možné zdroje jsou následující:

  • Local
  • Active Directory
  • AzureAD
  • MicrosoftAccount

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á.