Using PowerShell to manage GCP resources
How to configure PowerShell for managing GCP resources (Windows platform)
- Login to the machine using privileged account.
- From command prompt, run the command below to invoke PowerShell:
- powershell
- Note: You need to run cmd.exe or PowerShell.exe as administrator.
- Run the command below to find out the current PowerShell version:
- $PSVersionTable.PSVersion
- In-case you currently have version older than 5.1, follow the article below to locate the download URL for upgrading to the latest version of PowerShell:
- https://docs.microsoft.com/en-us/powershell/scripting/setup/installing-windows-powershell?view=powershell-6
- Also, review the article below for PowerShell installation pre-requirements:
- https://docs.microsoft.com/en-us/powershell/scripting/setup/windows-powershell-system-requirements?view=powershell-5.1
- Run the below command to check if you have PowerShellGet installed on your system:
- Get-Module PowerShellGet -list | Select-Object Name,Version,Path
- In-case you don’t have PowerShellGet, run the commands below:
- Install-PackageProvider Nuget –Force
- Install-Module -Name PowerShellGet –Force
- For more information about installation or upgrade of PowerShellGet, see:
- https://docs.microsoft.com/en-us/powershell/gallery/installing-psget
- Exit PowerShell console and command prompt.
- Install Google Cloud SDK, as instructed below:
- Run the following from command prompt to initialize the Cloud SDK:
- gcloud init --console-only
- Select a GCP project from the list
- Select a default Compute region and zone
How to configure PowerShell for managing GCP resources (CentOS platform)
- Login to the machine using privileged account.
- Run the command below to register the RedHat repository:
- curl https://packages.microsoft.com/config/rhel/7/prod.repo | sudo tee /etc/yum.repos.d/microsoft.repo
- Note: The above command should be written in a single line
- Run the command below to install PowerShell:
- sudo yum install -y powershell
- From command prompt, run the command below to invoke PowerShell:
- sudo pwsh
- Run the command below to find out the current PowerShell version:
- $PSVersionTable.PSVersion
- Run the below command to check if you have PowerShellGet installed on your system:
- Get-Module PowerShellGet -list | Select-Object Name,Version,Path
- In-case you don’t have PowerShellGet, run the commands below:
- Install-Module -Name PowerShellGet –Force
- For more information about installation or upgrade of PowerShellGet, see:
- https://docs.microsoft.com/en-us/powershell/gallery/installing-psget
- Install Google Cloud SDK, as instructed below:
- Run the following command to initialize the Cloud SDK:
- gcloud init --console-only
- Select a GCP project from the list
- Select a default Compute region and zone
- Run the command below to install Cloud SDK tools for PowerShell:
- Install-Module -Name GoogleCloud -Force
- List all available cmdlets of Google Cloud PowerShell SDK:
- Get-Command -CommandType Cmdlet -Module GoogleCloud*
Common PowerShell commands for GCP
- Login to Google Cloud Platform:
- gcloud auth login --no-launch-browser
- List all active GCP accounts:
- gcloud auth list
- Change the active account:
- gcloud config set account <Account_Name>
- Note: Replace <Account_Name> with the target GCP account
- Lists all available GCP projects:
- Get-GcpProject | select Name,ProjectId
- Change the GCP project:
- gcloud config set project “<Project_ID>”
- Note: Replace <Project_ID> with the target GCP project ID
- List available networks:
- Get-GceNetwork | select Name,AutoCreateSubnetworks,IPv4Range,GatewayIPv4
- Create a new network inside a specific GCP project:
- New-GceNetwork -Name "my-network" -IPv4Range <CIDR_Block> -Project "my-project"
- Note 1: The above commands should be written as a single line
- Note 2: Replace my-network with the relevant network name
- Note 3: Replace <CIDR_Block> with the relevant value (such as 10.240.0.0/16)
- Note 4: Replace my-project with the target GCP project ID
- Delete a network inside a specific GCP project:
- Remove-GceNetwork -Network "my-network" -Project "my-project"
- Note 1: Replace my-network with the relevant network name
- Note 2: Replace my-project with the target GCP project ID
- List all available Firewall rules inside a GCP project:
- Get-GceFirewall -Project "my-project" | select Name,Direction,Priority,Allowed,Denied
- Note: Replace my-project with the target GCP project ID
- List settings of a specific Firewall rule inside a GCP project:
- Get-GceFirewall "my-firewall" -Project "my-project"
- Note 1: Replace my-firewall with the specific firewall rule name
- Note 2: Replace my-project with the target GCP project ID
- Create a new Web allow firewall rule:
- New-GceFirewallProtocol tcp -Port 80 | Add-GceFirewall -Project "my-project" -Name "rule-name" -Network "my-network" -Description "Allow Web Traffic"
- Note 1: The above commands should be written as a single line
- Note 2: Replace 80 with the target port number
- Note 3: Replace my-project with the target GCP project ID
- Note 4: Replace rule-name with the target rule name
- Note 5: Replace my-network with the relevant network name
- Note 6: Replace "Allow Web Traffic" with a relevant rule description
- List all available VM instances in the current GCP project:
- Get-GceInstance
- List available VM instance image types, sorted by Name and Family:
- Get-GceImage | Format-Table Name,Family
- List all machine types:
- Get-GceMachineType | Format-Table Name,Zone,GuestCpus,MemoryMb,Deprecated
- Create a new CentOS 7 VM instance:
- $disk = Get-GceImage "centos-cloud" -Family "centos-7"
- $config = New-GceInstanceConfig "my-sample-vm" -MachineType "n1-standard-1" -Region europe-west2 -DiskImage $disk
- $config | Add-GceInstance -Project "my-project" -Zone "europe-west2-a"
- Note 1: The second command should be written as a single line
- Note 2: Replace centos-cloud with the relevant Image-project
- Note 3: Replace centos-7 with the relevant Image-family
- Note 4: Replace my-sample-vm with the target VM instance hostname
- Note 5: Replace n1-standard-1 with the relevant VM instance type, from the list:
- https://cloud.google.com/compute/docs/machine-types
- Note 6: Replace europe-west2 with the target region
- Note 7: Replace my-project with the target GCP project ID
- Note 7: Replace europe-west2-a with the target zone
- Get information about specific VM instance in a specific zone:
- Get-GceInstance "my-instance" -Project "my-project" -Zone "europe-west2-a"
- Note 1: Replace my-instance with the target VM instance hostname
- Note 2: Replace my-project with the target GCP project ID
- Note 3: Replace europe-west2-a with the target zone
- Start VM instance in a specific zone:
- Start-GceInstance -Name "my-instance" -Project "my-project" -Zone "europe-west2-a"
- Note 1: Replace my-instance with the target VM instance hostname
- Note 2: Replace my-project with the target GCP project ID
- Note 3: Replace europe-west2-a with the target zone
- Restart VM instance in a specific zone:
- Restart-GceInstance -Name "my-instance" -Project "my-project" -Zone "europe-west2-a"
- Note 1: The second command should be written as a single line
- Note 2: Replace my-instance with the target VM instance hostname
- Note 3: Replace my-project with the target GCP project ID
- Note 4: Replace europe-west2-a with the target zone
- Stop VM instance in a specific zone:
- Stop-GceInstance -Name "my-instance" -Project "my-project" -Zone "europe-west2-a"
- Note 1: Replace my-instance with the target VM instance hostname
- Note 2: Replace my-project with the target GCP project ID
- Note 3: Replace europe-west2-a with the target zone
- List all Google Cloud Storage buckets inside the current GCP project:
- Get-GcsBucket -Project "<Project_ID>" | select Name
- Note: Replace <Project_ID> with the target GCP project ID
- Create a new Google Cloud Storage bucket:
- New-GcsBucket -Name "my-bucket" -Project "<Project_ID>"
- Note 1: Replace my-bucket with the target bucket name
- Note 2: Replace <Project_ID> with the target GCP project ID
- Remove Google Cloud Storage bucket:
- Remove-GcsBucket "my-bucket" -Force
- Note: Replace my-bucket with the target bucket name