New-LocalGroup

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.

Kommentar

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.

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

-Description

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

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

-Name

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

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 för LocalUser-, LocalGroup- och 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.