Delen via

New-LocalGroup

Module:
Microsoft.PowerShell.LocalAccounts Module

Hiermee maakt u een lokale beveiligingsgroep.

Syntax

Default (Standaard) 

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

Description

Met de New-LocalGroup-cmdlet maakt u een lokale beveiligingsgroep in Security Account Manager.

Opmerking

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

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Description

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Name

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:0
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

String

U kunt een tekenreeks doorsluizen naar deze cmdlet.

Uitvoerwaarden

System.Management.Automation.SecurityAccountsManager.LocalGroup

Met deze cmdlet wordt een LocalGroup--object geretourneerd dat de gemaakte beveiligingsgroep vertegenwoordigt.

Notities

Windows PowerShell bevat de volgende aliassen voor New-LocalGroup:

  • nlg

De eigenschap PrincipalSource is een eigenschap in LocalUser, LocalGroupen 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.