Disable-LocalUser

  • Référence
Module:
Microsoft.PowerShell.LocalAccounts

Désactive un compte d’utilisateur local.

Syntax

Disable-LocalUser
       [-InputObject] <LocalUser[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-LocalUser
       [-Name] <String[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-LocalUser
       [-SID] <SecurityIdentifier[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

L’applet Disable-LocalUser de commande désactive les comptes d’utilisateur locaux. Lorsqu’un compte d’utilisateur est désactivé, l’utilisateur ne peut pas se connecter. Lorsqu’un compte d’utilisateur est activé, l’utilisateur peut se connecter.

Remarque

Le module Microsoft.PowerShell.LocalAccounts n’est pas disponible dans PowerShell 32 bits sur un système 64 bits.

Exemples

Exemple 1 : Désactiver un compte en spécifiant un nom

Disable-LocalUser -Name "Admin02"

Cette commande désactive le compte d’utilisateur nommé Administration 02.

Exemple 2 : Désactiver un compte à l’aide du pipeline

Get-LocalUser Guest | Disable-LocalUser

Cette commande obtient le compte invité intégré à l’aide Get-LocalUserde , puis le transmet à l’applet de commande actuelle à l’aide de l’opérateur de pipeline(|). Cette applet de commande désactive ce compte.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

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

-InputObject

Spécifie un tableau de comptes d’utilisateur que cette applet de commande désactive. Pour obtenir un compte d’utilisateur, utilisez l’applet de Get-LocalUser commande.

Type:Microsoft.PowerShell.Commands.LocalUser[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Spécifie un tableau de noms des comptes d’utilisateur que cette applet de commande désactive.

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

-SID

Spécifie un tableau de comptes d’utilisateur que cette applet de commande désactive.

Type:SecurityIdentifier[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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

Entrées

System.Management.Automation.SecurityAccountsManager.LocalUser

Vous pouvez diriger un utilisateur local vers cette applet de commande.

String

Vous pouvez diriger une chaîne vers cette applet de commande.

SecurityIdentifier

Vous pouvez diriger un SID vers cette applet de commande.

Sorties

None

Cette applet de commande ne retourne pas de sortie.

Notes

Windows PowerShell inclut les alias suivants pour Disable-LocalUser:

  • dlu

La propriété PrincipalSource est une propriété sur les objets LocalUser, LocalGroup et LocalPrincipal qui décrivent la source de l’objet. Les sources possibles sont les suivantes :

  • Local
  • Active Directory
  • Groupe Microsoft Entra
  • Compte Microsoft

PrincipalSource est pris en charge uniquement par Windows 10, Windows Server 2016 et versions ultérieures du système d’exploitation Windows. Pour les versions antérieures, la propriété est vide.