New-LocalGroup

  • Odwołanie
Moduł:
Microsoft.PowerShell.LocalAccounts

Tworzy lokalną grupę zabezpieczeń.

Składnia

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

Opis

Polecenie New-LocalGroup cmdlet tworzy lokalną grupę zabezpieczeń w Menedżerze kont zabezpieczeń.

Uwaga

Moduł Microsoft.PowerShell.LocalAccounts nie jest dostępny w 32-bitowym programie PowerShell w systemie 64-bitowym.

Przykłady

Przykład 1. Tworzenie grupy zabezpieczeń

New-LocalGroup -Name "SecurityGroup04"

To polecenie tworzy grupę o nazwie SecurityGroup04.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-Description

Określa komentarz dla grupy. Maksymalna długość to 48 znaków.

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

-Name

Określa nazwę grupy. Maksymalna długość to 256 znaków.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

Dane wejściowe

String

Możesz przekazać ciąg do tego polecenia cmdlet.

Dane wyjściowe

System.Management.Automation.SecurityAccountsManager.LocalGroup

To polecenie cmdlet zwraca obiekt LocalGroup reprezentujący utworzoną grupę zabezpieczeń.

Uwagi

Program Windows PowerShell zawiera następujące aliasy dla programu New-LocalGroup:

  • nlg

Właściwość PrincipalSource jest właściwością localuser, LocalGroup i LocalPrincipal obiektów opisujących źródło obiektu. Możliwe źródła są następujące:

  • Local
  • Active Directory
  • AzureAD
  • MicrosoftAccount

JednostkaSource jest obsługiwana tylko przez system Windows 10, Windows Server 2016 i nowsze wersje systemu operacyjnego Windows. W przypadku wcześniejszych wersji właściwość jest pusta.