gcloud beta compute reset-windows-password

NAME
gcloud beta compute reset-windows-password - reset and return a password for a Windows machine instance
SYNOPSIS
gcloud beta compute reset-windows-passwordINSTANCE_NAME[--user=USER][--zone=ZONE][GCLOUD_WIDE_FLAG …]
DESCRIPTION
(BETA)gcloud beta compute reset-windows-passwordallows a user to reset and retrieve a password for a Windows virtual machineinstance. If the Windows account does not exist, this command will cause theaccount to be created and the password for that new account will be returned.

For Windows instances that are running a domain controller, running this commandcreates a new domain user if the user does not exist, or resets the password ifthe user does exist. It is not possible to use this command to create a localuser on a domain-controller instance.

NOTE: When resetting passwords or adding a new user to a Domain Controller inthis way, the user will be added to the built in Admin Group on the DomainController. This will give the user wide reaching permissions. If this is notthe desired outcome then Active Directory Users and Computers should be usedinstead.

For all other instances, including domain-joined instances, running this commandcreates a local user or resets the password for a local user.

WARNING: Resetting a password for an existing user can cause the loss of dataencrypted with the current Windows password, such as encrypted files or storedpasswords.

The user running this command must have write permission for the Google ComputeEngine project containing the Windows instance.

EXAMPLES
To reset the password for user 'foo' on a Windows instance 'my-instance' in zone'us-central1-f', run:
gcloudbetacomputereset-windows-passwordmy-instance--zone=us-central1-f--user=foo
POSITIONAL ARGUMENTS
INSTANCE_NAME
Name of the instance to operate on. For details on valid instance names, referto the criteria documented under the field 'name' at:https://cloud.google.com/compute/docs/reference/rest/v1/instances
FLAGS
--user=USER
USER specifies the username to get thepassword for. If omitted, the username is derived from your authenticatedaccount email address.
--zone=ZONE
Zone of the instance to operate on. If not specified, you might be prompted toselect a zone (interactive mode only).gcloud attempts to identify theappropriate zone by searching for resources in your currently active project. Ifthe zone cannot be determined,gcloud prompts you for a selection withall available Google Cloud Platform zones.

To avoid prompting when this flag is omitted, the user can set thecompute/zone property:

gcloudconfigsetcompute/zoneZONE

A list of zones can be fetched by running:

gcloudcomputezoneslist

To unset the property, run:

gcloudconfigunsetcompute/zone

Alternatively, the zone can be stored in the environment variableCLOUDSDK_COMPUTE_ZONE.

GCLOUD WIDE FLAGS
These flags are available to all commands:--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.

Run$gcloud help for details.

NOTES
This command is currently in beta and might change without notice. Thesevariants are also available:
gcloudcomputereset-windows-password
gcloudalphacomputereset-windows-password

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-05-07 UTC.