Delen via

Disable-LocalUser

Module:
Microsoft.PowerShell.LocalAccounts Module

Hiermee schakelt u een lokaal gebruikersaccount uit.

Syntax

InputObject 

Disable-LocalUser
    [-InputObject] <LocalUser[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Default 

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

SecurityIdentifier 

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.

Opmerking

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

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:

Microsoft.PowerShell.Commands.LocalUser[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

InputObject
Position:0
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Name

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

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

Default
Position:0
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-SID

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

Parametereigenschappen

Type:

SecurityIdentifier[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SecurityIdentifier
Position:0
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-WhatIf

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

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

System.Management.Automation.SecurityAccountsManager.LocalUser

U kunt een lokale gebruiker deze cmdlet doorsluisen.

String

U kunt een tekenreeks doorsluizen 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.