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.

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

-Description

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

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

-Name

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

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.