Dela via

New-LocalGroup

  • Referens
Modul:
Microsoft.PowerShell.LocalAccounts

Skapar en lokal säkerhetsgrupp.

Syntax

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

Description

Cmdleten New-LocalGroup skapar en lokal säkerhetsgrupp i Säkerhetskontohanteraren.

Notera

Modulen Microsoft.PowerShell.LocalAccounts är inte tillgänglig i 32-bitars PowerShell i ett 64-bitarssystem.

Exempel

Exempel 1: Skapa en säkerhetsgrupp

New-LocalGroup -Name "SecurityGroup04"

Det här kommandot skapar en grupp med namnet SecurityGroup04.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Description

Anger en kommentar för gruppen. Den maximala längden är 256 tecken.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Anger ett namn för gruppen. Den maximala längden är 48 tecken.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdlet körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

Du kan skicka en sträng till den här cmdleten.

Utdata

System.Management.Automation.SecurityAccountsManager.LocalGroup

Den här cmdleten returnerar ett LocalGroup- objekt som representerar den skapade säkerhetsgruppen.

Kommentarer

Windows PowerShell innehåller följande alias för New-LocalGroup:

  • nlg

Egenskapen PrincipalSource är en egenskap på LocalUser, LocalGroupoch LocalPrincipal objekt som beskriver objektets källa. Möjliga källor är följande:

  • Local
  • Active Directory
  • AzureAD
  • MicrosoftAccount

PrincipalSource stöds endast av Windows 10, Windows Server 2016 och senare versioner av Windows-operativsystemet. För tidigare versioner är egenskapen tom.