Condividi tramite

New-LocalGroup

  • Riferimento
Modulo:
Microsoft.PowerShell.LocalAccounts

Crea un gruppo di sicurezza locale.

Sintassi

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

Descrizione

Il New-LocalGroup cmdlet crea un gruppo di sicurezza locale in Gestione account di sicurezza.

Nota

Il modulo Microsoft.PowerShell.LocalAccounts non è disponibile in PowerShell a 32 bit in un sistema a 64 bit.

Esempio

Esempio 1: Creare un gruppo di sicurezza

New-LocalGroup -Name "SecurityGroup04"

Questo comando crea un gruppo denominato SecurityGroup04.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Description

Specifica un commento per il gruppo. La lunghezza massima è di 48 caratteri.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specifica un nome per il gruppo. La lunghezza massima consentita è di 256 caratteri.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

È possibile inviare tramite pipe una stringa a questo cmdlet.

Output

System.Management.Automation.SecurityAccountsManager.LocalGroup

Questo cmdlet restituisce un oggetto LocalGroup che rappresenta il gruppo di sicurezza creato.

Note

Windows PowerShell include gli alias seguenti per New-LocalGroup:

  • nlg

La proprietà PrincipalSource è una proprietà sugli oggetti LocalUser, LocalGroup e LocalPrincipal che descrivono l'origine dell'oggetto. Le possibili origini sono le seguenti:

  • Local
  • Active Directory
  • AzureAD
  • MicrosoftAccount

PrincipalSource è supportato solo da Windows 10, Windows Server 2016 e versioni successive del sistema operativo Windows. Per le versioni precedenti, la proprietà è vuota.