Freigeben über

New-LocalGroup

  • Referenz
Modul:
Microsoft.PowerShell.LocalAccounts

Erstellt eine lokale Sicherheitsgruppe.

Syntax

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

Beschreibung

Das New-LocalGroup Cmdlet erstellt eine lokale Sicherheitsgruppe im Security Account Manager.

Hinweis

Das Microsoft.PowerShell.LocalAccounts-Modul ist in 32-Bit-PowerShell auf einem 64-Bit-System nicht verfügbar.

Beispiele

Beispiel 1: Erstellen einer Sicherheitsgruppe

New-LocalGroup -Name "SecurityGroup04"

Mit diesem Befehl wird eine Gruppe namens "SecurityGroup04" erstellt.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Gibt einen Kommentar für die Gruppe an. Die maximale Länge beträgt 48 Zeichen.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt einen Namen für die Gruppe an. Die maximale Länge beträgt 256 Zeichen.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

Sie können eine Zeichenfolge an dieses Cmdlet weiterleiten.

Ausgaben

System.Management.Automation.SecurityAccountsManager.LocalGroup

Dieses Cmdlet gibt ein LocalGroup-Objekt zurück, das die erstellte Sicherheitsgruppe darstellt.

Hinweise

Windows PowerShell enthält die folgenden Aliase für New-LocalGroup:

  • nlg

Die PrincipalSource-Eigenschaft ist eine Eigenschaft für LocalUser-, LocalGroup- und LocalPrincipal-Objekte , die die Quelle des Objekts beschreiben. Die möglichen Quellen sind wie folgt:

  • Local
  • Active Directory
  • AzureAD
  • MicrosoftAccount

PrincipalSource wird nur von Windows 10, Windows Server 2016 und höheren Versionen des Windows-Betriebssystems unterstützt. Bei früheren Versionen ist die Eigenschaft leer.