Share via

Disable-LocalUser

  • Referenz
Modul:
Microsoft.PowerShell.LocalAccounts

Deaktiviert ein lokales Benutzerkonto.

Syntax

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

Beschreibung

Das Disable-LocalUser Cmdlet deaktiviert lokale Benutzerkonten. Wenn ein Benutzerkonto deaktiviert ist, kann sich der Benutzer nicht anmelden. Wenn ein Benutzerkonto aktiviert ist, kann sich der Benutzer anmelden.

Hinweis

Das Microsoft.PowerShell.LocalAccounts-Modul ist in 32-Bit-PowerShell auf einem 64-Bit-System nicht verfügbar.

Beispiele

Beispiel 1: Deaktivieren eines Kontos durch Angeben eines Namens

Disable-LocalUser -Name "Admin02"

Mit diesem Befehl wird das Benutzerkonto "Admin02" deaktiviert.

Beispiel 2: Deaktivieren eines Kontos mithilfe der Pipeline

Get-LocalUser Guest | Disable-LocalUser

Mit diesem Befehl wird das integrierte Gastkonto mithilfe Get-LocalUserdes Pipelineoperators| () an das aktuelle Cmdlet übergeben. Mit diesem Cmdlet wird dieses Konto deaktiviert.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-InputObject

Gibt ein Array von Benutzerkonten an, das dieses Cmdlet deaktiviert. Verwenden Sie das Get-LocalUser Cmdlet, um ein Benutzerkonto zu erhalten.

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

-Name

Gibt ein Array von Namen der Benutzerkonten an, die dieses Cmdlet deaktiviert.

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

-SID

Gibt ein Array von Benutzerkonten an, das dieses Cmdlet deaktiviert.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

System.Management.Automation.SecurityAccountsManager.LocalUser

Sie können ein lokales Benutzer mit diesem Cmdlet weiterleiten.

String

Sie können eine Zeichenfolge an dieses Cmdlet weiterleiten.

SecurityIdentifier

Sie können eine SID an dieses Cmdlet weiterleiten.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Hinweise

Windows PowerShell enthält die folgenden Aliase für Disable-LocalUser:

  • dlu

Die PrincipalSource-Eigenschaft ist eine Eigenschaft für LocalUser-, LocalGroup- und LocalPrincipal-Objekte , die die Quelle des Objekts beschreiben. Die möglichen Quellen sind wie folgt:

  • Lokal
  • Active Directory
  • Microsoft Entra Gruppe
  • Microsoft-Konto

PrincipalSource wird nur von Windows 10, Windows Server 2016 und höheren Versionen des Windows-Betriebssystems unterstützt. Bei früheren Versionen ist die Eigenschaft leer.