Udostępnij za pośrednictwem

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 cmdlet New-LocalGroup tworzy lokalną grupę zabezpieczeń w Menedżerze kont zabezpieczeń.

Notatka

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

Prosi o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Description

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

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

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Możesz przesłać 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 New-LocalGroup:

  • nlg

Właściwość PrincipalSource jest właściwością obiektów LocalUser, LocalGroupi LocalPrincipal, która opisuje źródło obiektu. Możliwe źródła są następujące:

  • Local
  • Active Directory
  • AzureAD
  • MicrosoftAccount

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