Share via

New-LocalGroup

  • Referentie
Module:
Microsoft.PowerShell.LocalAccounts

Hiermee maakt u een lokale beveiligingsgroep.

Syntax

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

Description

De New-LocalGroup cmdlet maakt een lokale beveiligingsgroep in Security Account Manager.

Notitie

De module Microsoft.PowerShell.LocalAccounts is niet beschikbaar in 32-bits PowerShell op een 64-bits systeem.

Voorbeelden

Voorbeeld 1: Een beveiligingsgroep maken

New-LocalGroup -Name "SecurityGroup04"

Met deze opdracht maakt u een groep met de naam SecurityGroup04.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-Description

Hiermee geeft u een opmerking voor de groep. De maximale lengte is 48 tekens.

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

-Name

Hiermee geeft u een naam voor de groep. De maximale lengte is 256 tekens.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

String

U kunt een tekenreeks doorsluisen naar deze cmdlet.

Uitvoerwaarden

System.Management.Automation.SecurityAccountsManager.LocalGroup

Deze cmdlet retourneert een LocalGroup-object dat de gemaakte beveiligingsgroep vertegenwoordigt.

Notities

Windows PowerShell bevat de volgende aliassen voor New-LocalGroup:

  • nlg

De eigenschap PrincipalSource is een eigenschap voor LocalUser-, LocalGroup- en LocalPrincipal-objecten die de bron van het object beschrijven. De mogelijke bronnen zijn als volgt:

  • Local
  • Active Directory
  • AzureAD
  • MicrosoftAccount

PrincipalSource wordt alleen ondersteund door Windows 10, Windows Server 2016 en latere versies van het Windows-besturingssysteem. Voor eerdere versies is de eigenschap leeg.