New-LocalGroup

  • Reference
Modul:
Microsoft.PowerShell.LocalAccounts

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

Syntax

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

Description

Rutina New-LocalGroup vytvoří místní skupinu zabezpečení ve Správci účtů zabezpečení.

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 zobrazí výzvu k potvrzení.

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

-Description

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

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

-Name

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
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

String

Do této rutiny můžete zamísit ř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

PrincipalSource vlastnost je vlastnost localUser, LocalGroup a LocalPrincipal objekty, které popisují 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á.