Freigeben über

Disable-LocalUser

Modul:
Microsoft.PowerShell.LocalAccounts Module

Deaktiviert ein lokales Benutzerkonto.

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>]

Beschreibung

Mit dem Cmdlet Disable-LocalUser werden lokale Benutzerkonten deaktiviert. 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

Dieser Befehl ruft das integrierte Gastkonto mithilfe von Get-LocalUserab und übergibt es dann mithilfe des Pipelineoperators(|) an das aktuelle Cmdlet. Mit diesem Cmdlet wird dieses Konto deaktiviert.

Parameter

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-InputObject

Gibt ein Array von Benutzerkonten an, das dieses Cmdlet deaktiviert. Verwenden Sie zum Abrufen eines Benutzerkontos das cmdlet Get-LocalUser.

Parametereigenschaften

Typ:

Microsoft.PowerShell.Commands.LocalUser[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

InputObject
Position:0
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Name

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

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Default
Position:0
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-SID

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

Parametereigenschaften

Typ:

SecurityIdentifier[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

SecurityIdentifier
Position:0
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-WhatIf

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

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 Eigenschaft PrincipalSource ist eine Eigenschaft für LocalUser, LocalGroupund LocalPrincipal Objekte, die die Quelle des Objekts beschreibt. 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.