Condividi tramite

Set-LocalGroup

  • Riferimento
Modulo:
Microsoft.PowerShell.LocalAccounts

Modifica un gruppo di sicurezza locale.

Sintassi

Set-LocalGroup
   -Description <String>
   [-InputObject] <LocalGroup>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-LocalGroup
   -Description <String>
   [-Name] <String>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-LocalGroup
   -Description <String>
   [-SID] <SecurityIdentifier>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-LocalGroup modifica un gruppo di sicurezza locale.

Esempio

Esempio 1: Modificare una descrizione di un gruppo

Set-LocalGroup -Name "SecurityGroup04" -Description "This is a sample description."

Questo comando modifica la descrizione di un gruppo locale.

Nota

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

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:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specifica il gruppo di sicurezza modificato da questo cmdlet. Per ottenere un gruppo di sicurezza, usare il cmdlet Get-LocalGroup.

Tipo:Microsoft.PowerShell.Commands.LocalGroup
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specifica il nome del gruppo di sicurezza modificato da questo cmdlet.

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

-SID

Specifica l'ID di sicurezza (SID) del gruppo di sicurezza modificato da questo cmdlet.

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

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. 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

System.Management.Automation.SecurityAccountsManager.LocalGroup

È possibile inviare tramite pipe un gruppo di sicurezza a questo cmdlet.

String

È possibile inviare tramite pipe una stringa a questo cmdlet.

SecurityIdentifier

È possibile inviare tramite pipe un SID a questo cmdlet.

Output

None

Questo cmdlet non restituisce alcun output.

Note

Windows PowerShell include gli alias seguenti per Set-LocalGroup:

  • slg

La proprietà PrincipalSourceLocalUser, LocalGroupe LocalPrincipal che descrive l'origine dell'oggetto. Le possibili origini sono le seguenti:

  • Locale
  • Active Directory
  • Gruppo Microsoft Entra
  • Microsoft Account

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