Panduan memulai

Google Cloud Tools for PowerShell adalah kumpulan cmdlet untuk mengakses dan memanipulasi Google Cloud resource. cmdlet adalah perintah ringan yang dipanggil dalam PowerShell, alat otomatisasi yang terdiri dari shell command line, bahasa pembuatan skrip, dan framework pengelolaan konfigurasi. PowerShell berjalan di Windows, Linux, dan macOS.

Panduan memulai ini menunjukkan cara mengaktifkan Cloud Tools for PowerShell, melakukan autentikasi dengan gcloud CLI, dan menjalankan cmdlet PowerShell.

Sebelum memulai

Selesaikan langkah-langkah berikut:

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.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. Di command line PowerShell lokal, instal Cloud Tools for PowerShell dengan menjalankan perintah berikut sebagai administrator:

   Install-Module GoogleCloud

   1. Saat pertama kali menggunakan modul, Anda akan diminta untuk menginstal gcloud CLI, yang diperlukan untuk menggunakan Cloud Tools for PowerShell. Pilih 'Yes' untuk mendownload dan menginstal gcloud CLI.

Melakukan autentikasi dengan gcloud CLI

Cloud Tools for PowerShell menggunakan kredensial dan setelan Anda yang disimpan di gcloud CLI untuk mengaktifkan cmdlet. Untuk menggunakan cmdlet, login terlebih dahulu menggunakan gcloud CLI:

1. Di command prompt, jalankan perintah berikut:

   gcloud init

2. Terima opsi untuk login menggunakan akun pengguna Google Anda:

   To continue, you must log in. Would you like to log in (Y/n)? Y

3. Di browser, login ke akun pengguna Google Anda saat diminta dan klik Izinkan untuk memberikan izin akses ke Google Cloud resource.

4. Di command prompt, pilih project Google Cloud tempat Anda memiliki izin Pemilik, Editor, atau Pengakses Lihat Saja:

   Pick a cloud project to use:
   [1] [my-project-1]
   [2] [my-project-2]
   ...
   Please enter your numeric choice:

Menjalankan cmdlet PowerShell

Setelah melakukan autentikasi, Anda dapat mulai menggunakan Cloud Tools for PowerShell. Buka jendela PowerShell dan coba jalankan perintah berikut.

Mendapatkan semua bucket untuk project saat ini, untuk project tertentu, atau bucket tertentu:

$currentProjBuckets = Get-GcsBucket
$specificProjBuckets = Get-GcsBucket -Project my-project-1
$bucket = Get-GcsBucket -Name my-bucket-name

Mencantumkan semua instance Compute Engine yang terkait dengan project:

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

Menjelajahi Cloud Storage dengan penyedia PowerShell

Cloud Tools for PowerShell mencakup penyedia PowerShell untuk Cloud Storage. Penyedia ini memungkinkan Anda menggunakan perintah seperti cd, dir, copy, dan del untuk menjelajahi dan memanipulasi data Anda di Cloud Storage seolah-olah data tersebut berada di sistem file lokal.

Untuk menggunakan penyedia secara langsung, Anda dapat memulai Cloud Tools for PowerShell menggunakan pintasan dari menu start. Tindakan ini akan meluncurkan konsol PowerShell dengan penyedia yang dimuat:

# Navigate to Cloud Storage
cd gs:\
# Show the available buckets
ls
# Create a new bucket
mkdir my-new-bucket

Anda juga dapat menyediakan penyedia Cloud Storage di sesi PowerShell mana pun dengan mengimpor modul Cloud Tools for PowerShell melalui Import-Module GoogleCloud.

Langkah berikutnya

Anda dapat mempelajari lebih lanjut cmdlet tertentu dengan melihat referensi cmdlet Cloud Tools for PowerShell, atau dengan menggunakan sistem bantuan bawaan dari dalam PowerShell:

Get-Help New-GcsBucket