Condividi tramite

Remove-LocalGroup

  • Riferimento
Modulo:
Microsoft.PowerShell.LocalAccounts

Elimina i gruppi di sicurezza locali.

Sintassi

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

Descrizione

Il cmdlet Remove-LocalGroup elimina i gruppi di sicurezza locali. Questo cmdlet elimina solo un gruppo locale. Non elimina gli account utente, gli account computer o gli account di gruppo che appartengono a tale gruppo. Non è possibile recuperare un gruppo eliminato.

Se si elimina un gruppo e quindi si crea un altro gruppo con lo stesso nome di gruppo, è necessario impostare nuove autorizzazioni per il nuovo gruppo. Il nuovo gruppo non eredita le autorizzazioni assegnate al gruppo.

Nota

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

Esempio

Esempio 1: Eliminare un gruppo di sicurezza

Remove-LocalGroup -Name "SecurityGroup04"

Questo comando elimina il 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

-InputObject

Specifica una matrice di gruppi di sicurezza eliminati da questo cmdlet. Per ottenere i gruppi, 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 una matrice di nomi dei gruppi di sicurezza eliminati da questo cmdlet.

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

-SID

Specifica una matrice di ID di sicurezza (SID) dei gruppi di sicurezza eliminati 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 Remove-LocalGroup:

  • rlg

Questo cmdlet non può eliminare i gruppi predefiniti seguenti:

  • Gli amministratori
  • Operatori di backup
  • Operatori di crittografia
  • Utenti COM distribuiti
  • Lettori del registro eventi
  • Ospiti
  • amministratori di Hyper-V
  • IIS_IUSRS
  • Operatori di configurazione di rete
  • Utenti del log delle prestazioni
  • Utenti di Performance Monitor
  • Utenti esperti
  • Utenti desktop remoto
  • Utenti di gestione remota
  • Replicatore
  • Gli utenti
  • WinRMRemoteWMIUsers__

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.