Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En esta página, se muestra cómo habilitar Cloud Tools for PowerShell, autenticar con gcloud CLI y ejecutar cmdlets de PowerShell.
Antes de comenzar
Completa los siguientes pasos:
Sign in to your Google Cloud account. If you're new to
Google Cloud,
create an account to evaluate how our products perform in
real-world scenarios. New customers also get $300 in free credits to
run, test, and deploy workloads.
In the Google Cloud console, on the project selector page,
select or create a Google Cloud project.
Instala gcloud CLI desde la línea de comandos de PowerShell. Para ello, ejecuta el siguiente comando como administrador:
Install-Module GoogleCloud
Autentícate con gcloud CLI
Cloud Tools for PowerShell usa tus credenciales y parámetros de configuración almacenados en gcloud CLI para habilitar los cmdlets. Para usar los cmdlets, primero accede con gcloud CLI:
En el símbolo del sistema, ejecuta el siguiente comando:
gcloud init
Acepta la opción para acceder con tu cuenta de usuario de Google:
To continue, you must log in. Would you like to log in (Y/n)? Y
En tu navegador, accede a tu cuenta de usuario de Google cuando se te solicite y haz clic en Permitir para autorizar el acceso a los recursos de Google Cloud .
En el símbolo del sistema, selecciona un Google Cloud proyecto en el que tengas permisos de propietario, editor o visualizador:
Pick a cloud project to use:
[1] [my-project-1]
[2] [my-project-2]
...
Please enter your numeric choice:
Ejecuta cmdlets de PowerShell
Después de la autenticación, puedes comenzar a usar Cloud Tools for PowerShell. Abre una ventana de PowerShell y, luego, intenta ejecutar los siguientes comandos.
Obtén todos los bucket s para el proyecto actual, un proyecto específico o un bucket específico:
Haz una lista de todas las instancias de Compute Engine asociadas con un proyecto:
Get-GceInstance -Project my-project-1 |
Sort Status |
Format-Table Name, Status -GroupBy Status
Status: RUNNING
Name Status
---- ------
my-vm-2 RUNNING
my-vm-3 RUNNING
Status: TERMINATED
Name Status
---- ------
my-vm-1 TERMINATED
Navega en Cloud Storage con el proveedor de PowerShell
Cloud Tools for PowerShell incluye un proveedor de PowerShell para Cloud Storage. Este proveedor te permite usar comandos como cd, dir, copy y del para navegar y manipular tus datos en Cloud Storage como si estuvieran en una ubicación local. sistema de archivos.
Para usar el proveedor de manera directa, puedes iniciar Cloud Tools for PowerShell con el acceso directo del menú de inicio. Con esto se iniciará una consola de PowerShell con el proveedor cargado:
# Navigate to Cloud Storage
cd gs:\
# Show the available buckets
ls
# Create a new bucket
mkdir my-new-bucket
También puedes hacer que el proveedor de Cloud Storage esté disponible en cualquier sesión de PowerShell. Para ello, importa el módulo de Cloud Tools for PowerShell a través de Import-Module GoogleCloud.
¿Qué sigue?
Puedes obtener más información sobre cmdlets específicos. Para ello, consulta la referencia del cmdlet de Cloud Tools for PowerShell o usa el sistema de ayuda integrado de PowerShell:
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (UTC)"],[],[],null,["# Quickstart\n\nThis page shows how to enable Cloud Tools for PowerShell, authenticate\nwith the gcloud CLI, and run PowerShell cmdlets.\n\nBefore you begin\n----------------\n\nComplete the following steps:\n\n- Sign in to your Google Cloud account. If you're new to Google Cloud, [create an account](https://console.cloud.google.com/freetrial) to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.\n- In the Google Cloud console, on the project selector page,\n select or create a Google Cloud project.\n\n | **Note**: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.\n\n [Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n-\n [Verify that billing is enabled for your Google Cloud project](/billing/docs/how-to/verify-billing-enabled#confirm_billing_is_enabled_on_a_project).\n\n- In the Google Cloud console, on the project selector page,\n select or create a Google Cloud project.\n\n | **Note**: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.\n\n [Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n-\n [Verify that billing is enabled for your Google Cloud project](/billing/docs/how-to/verify-billing-enabled#confirm_billing_is_enabled_on_a_project).\n\n1. Install the gcloud CLI from the PowerShell command line by running the following command as an administrator: \n\n```\nInstall-Module GoogleCloud\n```\n\n\u003cbr /\u003e\n\nAuthenticate with gcloud CLI\n----------------------------\n\nCloud Tools for PowerShell uses your credentials and settings stored in the\ngcloud CLI to enable the cmdlets. To use the cmdlets, first log in\nusing the gcloud CLI:\n\n1. At the command prompt, run the following command:\n\n ```\n gcloud init\n ```\n2. Accept the option to log in using your Google user account:\n\n `To continue, you must log in. Would you like to log in (Y/n)? Y`\n3. In your browser, log in to your Google user account when prompted and click\n **Allow** to grant permission to access Google Cloud resources.\n\n4. At the command prompt, select a Google Cloud project in which you\n have Owner, Editor, or Viewer permissions:\n\n ```\n Pick a cloud project to use:\n [1] [my-project-1]\n [2] [my-project-2]\n ...\n Please enter your numeric choice:\n ```\n\nRun PowerShell cmdlets\n----------------------\n\nAfter authenticating, you can start using Cloud Tools for PowerShell. Open a\nPowerShell window and try running the following commands.\n\nGet all buckets for the current project, for a specific project, or a specific\nbucket: \n\n```\n$currentProjBuckets = Get-GcsBucket\n$specificProjBuckets = Get-GcsBucket -Project my-project-1\n$bucket = Get-GcsBucket -Name my-bucket-name\n```\n\nList all Compute Engine instances associated with a project: \n\n```\nGet-GceInstance -Project my-project-1 |\n Sort Status |\n Format-Table Name, Status -GroupBy Status\n\n Status: RUNNING\n\nName Status\n---- ------\nmy-vm-2 RUNNING\nmy-vm-3 RUNNING\n\n Status: TERMINATED\n\nName Status\n---- ------\nmy-vm-1 TERMINATED\n```\n\nNavigate Cloud Storage with PowerShell provider\n-----------------------------------------------\n\nCloud Tools for PowerShell includes a PowerShell provider for\nCloud Storage. This provider allows you to use commands like\n`cd`, `dir`, `copy` and `del` to navigate and manipulate your data in\nCloud Storage as if the data were on a local file system.\n\nTo directly use the provider, you can start Cloud Tools for PowerShell using\nthe shortcut from the start menu. This will launch a PowerShell console with the\nprovider loaded: \n\n```\n# Navigate to Cloud Storage\ncd gs:\\\n# Show the available buckets\nls\n# Create a new bucket\nmkdir my-new-bucket\n```\n\nYou can also make the Cloud Storage provider available in any\nPowerShell session by importing the Cloud Tools for PowerShell module via\n`Import-Module GoogleCloud`.\n\nWhat's next\n-----------\n\nYou can learn more about specific cmdlets by referring to the\nCloud Tools for PowerShell [cmdlet\nreference](https://googlecloudplatform.github.io/google-cloud-powershell), or by\nusing the built-in help system from within PowerShell: \n\n```\nGet-Help New-GcsBucket\n```"]]
