Compartir a través de

Disable-LocalUser

  • Referencia
Módulo:
Microsoft.PowerShell.LocalAccounts

Deshabilita una cuenta de usuario local.

Sintaxis

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

Description

El Disable-LocalUser cmdlet deshabilita las cuentas de usuario locales. Cuando se deshabilita una cuenta de usuario, el usuario no puede iniciar sesión. Cuando se habilita una cuenta de usuario, el usuario puede iniciar sesión.

Nota:

El módulo Microsoft.PowerShell.LocalAccounts no está disponible en PowerShell de 32 bits en un sistema de 64 bits.

Ejemplos

Ejemplo 1: Deshabilitar una cuenta especificando un nombre

Disable-LocalUser -Name "Admin02"

Este comando deshabilita la cuenta de usuario denominada Admin02.

Ejemplo 2: Deshabilitar una cuenta mediante la canalización

Get-LocalUser Guest | Disable-LocalUser

Este comando obtiene la cuenta de invitado integrada mediante Get-LocalUsery, a continuación, la pasa al cmdlet actual mediante el operador de canalización(|). Ese cmdlet deshabilita esa cuenta.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

Especifica una matriz de cuentas de usuario que este cmdlet deshabilita. Para obtener una cuenta de usuario, use el Get-LocalUser cmdlet .

Tipo:Microsoft.PowerShell.Commands.LocalUser[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

Especifica una matriz de nombres de las cuentas de usuario que deshabilita este cmdlet.

Tipo:String[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SID

Especifica una matriz de cuentas de usuario que este cmdlet deshabilita.

Tipo:SecurityIdentifier[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

System.Management.Automation.SecurityAccountsManager.LocalUser

Puede canalizar a un usuario local este cmdlet.

String

Puede canalizar una cadena a este cmdlet.

SecurityIdentifier

Puede canalizar un SID a este cmdlet.

Salidas

None

Este cmdlet no devuelve ningún resultado.

Notas

Windows PowerShell incluye los siguientes alias para Disable-LocalUser:

  • dlu

La propiedad PrincipalSource es una propiedad en objetos LocalUser, LocalGroup y LocalPrincipal que describen el origen del objeto. Los orígenes posibles son los siguientes:

  • Local
  • Active Directory
  • Grupo de Microsoft Entra
  • Cuenta Microsoft

PrincipalSource solo es compatible con Windows 10, Windows Server 2016 y versiones posteriores del sistema operativo Windows. Para versiones anteriores, la propiedad está en blanco.