Delen via

Disable-LocalUser

  • Referentie
Module:
Microsoft.PowerShell.LocalAccounts

Hiermee schakelt u een lokaal gebruikersaccount uit.

Syntaxis

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

Description

Met de cmdlet Disable-LocalUser worden lokale gebruikersaccounts uitgeschakeld. Wanneer een gebruikersaccount is uitgeschakeld, kan de gebruiker zich niet aanmelden. Wanneer een gebruikersaccount is ingeschakeld, kan de gebruiker zich aanmelden.

Notitie

De module Microsoft.PowerShell.LocalAccounts is niet beschikbaar in 32-bits PowerShell op een 64-bits systeem.

Voorbeelden

Voorbeeld 1: Een account uitschakelen door een naam op te geven

Disable-LocalUser -Name "Admin02"

Met deze opdracht wordt het gebruikersaccount met de naam Admin02 uitgeschakeld.

Voorbeeld 2: Een account uitschakelen met behulp van de pijplijn

Get-LocalUser Guest | Disable-LocalUser

Met deze opdracht wordt het ingebouwde gastaccount met behulp van Get-LocalUseren vervolgens doorgegeven aan de huidige cmdlet met behulp van de pijplijnoperator(|). Met deze cmdlet wordt dat account uitgeschakeld.

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

Hiermee geeft u een matrix van gebruikersaccounts op die door deze cmdlet wordt uitgeschakeld. Gebruik de cmdlet Get-LocalUser om een gebruikersaccount te verkrijgen.

Type:Microsoft.PowerShell.Commands.LocalUser[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u een matrix van namen van de gebruikersaccounts die door deze cmdlet wordt uitgeschakeld.

Type:String[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SID

Hiermee geeft u een matrix van gebruikersaccounts op die door deze cmdlet wordt uitgeschakeld.

Type:SecurityIdentifier[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

System.Management.Automation.SecurityAccountsManager.LocalUser

U kunt een lokale gebruiker deze cmdlet doorsluisen.

String

U kunt een tekenreeks doorsluisen naar deze cmdlet.

SecurityIdentifier

U kunt een SID doorsluisen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.

Notities

Windows PowerShell bevat de volgende aliassen voor Disable-LocalUser:

  • dlu

De eigenschap PrincipalSource is een eigenschap in LocalUser, LocalGroupen LocalPrincipal-objecten die de bron van het object beschrijven. De mogelijke bronnen zijn als volgt:

  • Lokaal
  • Active Directory
  • Microsoft Entra-groep
  • Microsoft-account

PrincipalSource wordt alleen ondersteund door Windows 10, Windows Server 2016 en latere versies van het Windows-besturingssysteem. Voor eerdere versies is de eigenschap leeg.