AGMPowerCLIFindFunctions.ps1

# Copyright 2022 Google Inc. All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

<#
.SYNOPSIS
Find the host name of a vCenter by its vCenter ID.

.EXAMPLE
Find-vCenterHostName -vCenterId 6880886
#>
function Find-vCenterHostName {
  [CmdletBinding()]
  param (
      # The `id` of the vCenter host, you can find the `id` by `(Get-AGMHost -filtervalue "isvcenterhost=true") | Select-Object id,name`
      [Parameter(Mandatory = $true)]
      [int]
      $vCenterId
  )

  (Get-AGMHost -filtervalue "isvcenterhost=true&id=$vCenterId").hostname
}

<#
.SYNOPSIS
Find the VMs with the specified tag name.

.EXAMPLE
Find-vCenterTaggedVMs -VmTag 'MyVMTag'
#>
function Find-vCenterTaggedVMs {
  [CmdletBinding()]
  param (
      # Tag name that is associated with the VMs
      [Parameter(Mandatory = $true)]
      [string]
      $VmTag
  )

  $vcenter_vms_to_protect = @()
  Invoke-ListTag | ForEach-Object {
      $tag = Invoke-GetTagId -TagId $_
      if ($tag.name -eq $VmTag) {
          $tagged_vms = Invoke-ListAttachedObjectsTagIdTagAssociation -TagId $tag.id | Where-Object { $_.type -eq "VirtualMachine" }
          
          $tagged_vms | ForEach-Object {
              $vm_details = Invoke-GetVm -Vm $_.id
              $vcenter_vms_to_protect += [PSCustomObject]@{
                  id   = $_.id
                  name = $vm_details.name
                  uuid = $vm_details.identity.instance_uuid
              }
          }
          break
      }
  }

  return $vcenter_vms_to_protect
}