Dela via

New-LocalGroup

Modul:
Microsoft.PowerShell.LocalAccounts Module

Skapar en lokal säkerhetsgrupp.

Syntax

Default (Standard) 

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

Description

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

Anmärkning

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.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Description

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Name

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

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:0
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-WhatIf

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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.