Re: Adding a Tag to A VM?

aplechaty · ‎07-19-2022

I have a script currently for deploying virtual machines. What I am looking to do is prompt the user with a list of Tags to select from as follows.

$Tags = "DEV-2-Week-Linux","DEV-4-Week-Linux","PROD-2-Week-Linux","PROD-2-Week-Windows"

So as the script runs I want the user to be prompted to select one of the tags. They make their selection and the script continues on. I then need the script at some point to assign the selected tag to the VM as it is created.

I am having a hard time figuring out how to actually set the tag on the newly created VM. Any help is greatly appreciated. Thanks in advance.

LucD · ‎07-19-2022

You can use the New-TagAssignment cmdlet for that.

Blog: lucd.info Twitter: @LucD22 Co-author PowerCLI Reference

aplechaty · ‎07-19-2022

Thanks, I am looking for the exact string that would assign the tag selected. I'm not quite sure how to format the command using a pulled in variable? Also this script creates the Vm it doesn't already exist so how do I add an entity that is yet to be created?

aplechaty · ‎07-19-2022

Here is my script below, as you can see I added the Backup tag variable now I just need the proper command to assign the selected tag to the VM.

On a separate note, I am also getting an error on line 130 which I have Italics below.

#Variables

$VCenterServer = "myvcenter.domain.net"

$Environments = "PROD","DEV"

$BusinessDivisions = "Corporate","DevOps","EA","ECM","EDI","Network Services","RCO","RCS"

$ServerFunctions = "Application","Web","Database","File","Management"

$DMZDomain = "domain.dmz"

$InternalDomain = "domain.net"

$DMZDNS = Resolve-DnsName -Type NS -Name $DMZDomain

$InternalDNS = Resolve-DnsName -Type NS -Name $InternalDomain

$IPPattern = "^([1-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])(\.([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])){3}$"

$CurrentDate = Get-Date -Format d

$BackupTag = "DomainControllers","DEV-2-Week-Linux","DEV-2-Week-Windows","DEV-4-Week-Linux","DEV-4-Week-Windows","PROD-2-Week-Linux","PROD-2-Week-Windows",'PROD-4-Week-Linux","PROD-4-Week-Windows"

#Functions

#Quick function to give the user a prompt of specific options.

function Get-UserPrompt {

param (

[Parameter(Mandatory=$true)]

[string[]]$Options,

[Parameter(Mandatory=$true)]

[string]$Prompt

)

[int]$Response = 0;

[bool]$ValidResponse = $false

while (!($ValidResponse)) {

[int]$OptionNo = 0

Write-Host $Prompt -ForegroundColor DarkYellow

Write-Host "[0]: Cancel"

foreach ($Option in $Options) {

$OptionNo += 1

Write-Host ("[$OptionNo]: {0}" -f $Option)

}

if ([Int]::TryParse((Read-Host), [ref]$Response)) {

if ($Response -eq 0) {

return ''

}

elseif($Response -le $OptionNo) {

$ValidResponse = $true

}

return $Options.Get($Response - 1)

}

#Quick function to request specified information.

Function Get-DeploymentVariables{

param(

[Parameter(Mandatory=$true)]

[string]$Prompt

)

Write-Host $Prompt -ForegroundColor DarkYellow

Read-Host

}

#Pull correct folder by specifying the path. Copied directly from: https://www.lucd.info/2012/05/18/folder-by-path/

function Get-FolderByPath{

<#

.SYNOPSIS Retrieve folders by giving a path

.DESCRIPTION The function will retrieve a folder by it's path.

The path can contain any type of leave (folder or datacenter).

.NOTES

Author: Luc Dekens .PARAMETER Path The path to the folder. This is a required parameter.

.PARAMETER

Path The path to the folder. This is a required parameter.

.PARAMETER

Separator The character that is used to separate the leaves in the path. The default is '/'

.EXAMPLE

PS> Get-FolderByPath -Path "Folder1/Datacenter/Folder2"

.EXAMPLE

PS> Get-FolderByPath -Path "Folder1>Folder2" -Separator '>'

#>

param(

[CmdletBinding()]

[parameter(Mandatory = $true)]

[System.String[]]${Path},

[char]${Separator} = '/'

)

process{

if((Get-PowerCLIConfiguration).DefaultVIServerMode -eq "Multiple"){

$vcs = $global:defaultVIServers

}

else{

$vcs = $global:defaultVIServers[0]

}

$folders = @()

foreach($vc in $vcs){

$si = Get-View ServiceInstance -Server $vc

$rootName = (Get-View -Id $si.Content.RootFolder -Property Name).Name

foreach($strPath in $Path){

$root = Get-Folder -Name $rootName -Server $vc -ErrorAction SilentlyContinue

$strPath.Split($Separator) | ForEach-Object{

$root = Get-Inventory -Name $_ -Location $root -NoRecursion -Server $vc -ErrorAction SilentlyContinue

if((Get-Inventory -Location $root -NoRecursion | Select-Object -ExpandProperty Name) -contains "vm"){

$root = Get-Inventory -Name "vm" -Location $root -Server $vc -NoRecursion

}

$root | Where-Object {$_ -is [VMware.VimAutomation.ViCore.Impl.V1.Inventory.FolderImpl]}|ForEach-Object{

$folders += Get-Folder -Name $_.Name -Location $root.Parent -NoRecursion -Server $vc

}

$folders

}

#Connect to VCenter Server. Will prompt for credentials.

Connect-VIServer $VCenterServer

#Prompts for all variables.

#PROD/DEV/QA/TEST.

$ChosenEnvironment = Get-UserPrompt -Options $Environments -Prompt "Choose Environment."

if($ChosenEnvironment -eq "PROD"){

$ChosenHost = Get-VMHost -Location "Expedient Production" | Sort-Object MemoryUsageGB -Descending | Select-Object -Last 1

$FolderPathStart = "Expedient Production/"

$ChosenCluster = Get-Cluster -Name "Expedient Production"

}

if($ChosenEnvironment -eq "DEV"){

$ChosenHost = Get-VMHost -Location "Expedient Development" | Sort-Object MemoryUsageGB -Descending | Select-Object -Last 1

$FolderPathStart = "Expedient Development/"

$ChosenCluster = "Expedient Development"

$ChosenCluster = Get-Cluster -Name "Expedient Development"

}

#Business Division

$ChosenDivision = Get-UserPrompt -Options $BusinessDivisions -Prompt "Choose Business Division."

#VM Notes

$ChosenNotes = Get-DeploymentVariables -Prompt "Enter VM Notes"

#Server Owner

$ChosenOwner = Get-DeploymentVariables -Prompt "Enter Server Owner"

#Server Function

$ChosenFunction = Get-UserPrompt -Options $ServerFunctions -Prompt "Choose Server Function"

#Creator

$ChosenCreator = Get-DeploymentVariables -Prompt "Enter Your Name"

#HD Event

$ChosenHDEvent = Get-DeploymentVariables -Prompt "Enter HD Event Number"

#Domain.

$ChosenDomain = Get-UserPrompt -Options ("DMZ","Internal") -Prompt "Choose Domain."

#OS.

$ChosenOS = Get-UserPrompt -Options ("2019","2022") -Prompt "Choose OS."

if($ChosenOS -eq "2019"){

$ChosenTemplate = Get-Template -Name "SRV2019_Template"

}

if($ChosenOS -eq "2022"){

$ChosenTemplate = Get-Template -Name "SRV2022_Template"

}

#Name.

$ChosenName = Get-DeploymentVariables -Prompt "Enter Server Name"

#Network. This may need to change when we switch to distributed switches.

$VMNetworks = Get-VirtualPortGroup | Sort-Object Name | Get-Unique

$ChosenNetwork = Get-UserPrompt -Options $VMNetworks -Prompt "Choose Network."

Do{

$ChosenIP = Get-DeploymentVariables -Prompt "Enter IP Address."

$IPTest = $null

$IPTest = Test-Connection $ChosenIP -ErrorAction Ignore

$IPCheck = $ChosenIP -match $IPPattern

if($IPCheck -eq $true){

if($null -ne $IPTest){

Write-Host "IP is already in use. Try again." -ForegroundColor Red

}}

if($IPCheck -eq $false) {

Write-Host "Invalid IP address. Please try again." -ForegroundColor Red

}

Until ($null -eq $IPTest -and $IPCheck -eq $true)

Do{

$ChosenMask = $null

$ChosenMask = Get-DeploymentVariables -Prompt "Enter Subnet Mask."

$MaskCheck = $ChosenMask -match $IPPattern

If($MaskCheck -eq $false){

Write-Host "Invalid Subnet Mask. Try again." -ForegroundColor Red

}

Until ($MaskCheck -eq $true)

Do{

$ChosenGateway = $null

$ChosenGateway = Get-DeploymentVariables -Prompt "Enter Gateway."

$GatewayCheck = $ChosenGateway -match $IPPattern

If($GatewayCheck -eq $false){

Write-Host "Invalid gateway, try again." -ForegroundColor Red

}

Until ($GatewayCheck -eq $true)

#Datastore.

if($ChosenEnvironment -eq "DEV"){

$Datastores = Get-DatastoreCluster -Location "Mydomain Development" | Select-Object Name

$ChosenDatastore = Get-UserPrompt -Options $Datastores.Name -Prompt "Choose Datastore"

}

if($ChosenEnvironment -eq "PROD"){

$Datastores = Get-DatastoreCluster -Location "Mydomain Production" | Select-Object Name

$ChosenDatastore = Get-UserPrompt -Options $Datastores.Name -Prompt "Choose Datastore"

}

#Socket count.

$ChosenSockets = Get-UserPrompt -Options ("2","4","6","8","10","12") -Prompt "Choose Number of Cores"

#Core count.

#$ChosenCores = Get-UserPrompt -Options ("2","3","4","5","6") -Prompt "Choose Number of Cores Per Socket"

$ChosenCores = $ChosenSockets/2

#Memory.

$ChosenMemory = Get-UserPrompt -Options ("6","8","10","12","14","16") -Prompt "Choose Memory GB"

#Update group.

$ADUpdateGroup = Get-ADGroup -Filter {Name -Like "*WSUS*" -and Name -NotLike "WSUSUpdates"} | Sort-Object Name

$ChosenUpdateGroup = Get-UserPrompt -Options $ADUpdateGroup.Name -Prompt "Choose Update Group"

#Script

#Confirm chosen options are correct.

$Title = "Confirmation"

$Prompt = "Verify the following selections:

Environment - $ChosenEnvironment

Business Division - $ChosenDivision

Owner = $ChosenOwner

Server Function - $ChosenFunction

Notes - $ChosenNotes

Creator - $ChosenCreator

Helpdesk - $ChosenHDEvent

Creation Date - $CurrentDate

Domain - $ChosenDomain

OS - $ChosenOS

Name - $ChosenName

VM Network - $ChosenNetwork

IP Address - $ChosenIP

Subnet Mask - $ChosenMask

Gateway - $ChosenGateway

Datastore - $ChosenDatastore

Socket Count - $ChosenSockets

Core Count Per Socket - $ChosenCores

Memory - $ChosenMemory

Update Group - $ChosenUpdateGroup

`nAre you sure you want to continue?

`nYou will need to manually undo any changes that happen after this point."

$Choices = [System.Management.Automation.Host.ChoiceDescription[]] @("Yes", "Cancel")

$Default = 1

$Choice = $host.UI.PromptForChoice($Title, $Prompt, $Choices, $Default)

switch($Choice)

{

0 {Write-Host "Continuing.

Please Wait your Virtual Machine build is in progress! Once the cursosr has returned you can close this Powershell window and proceed to vCenter for any additional configuration!

" -ForegroundColor Green}

1 {Write-Host "Cancelling." -ForegroundColor Red

Return}

}

#Deploy VM. Must program in wait for spin-up.

#Select OS Customization Spec

if($ChosenDomain -eq "DMZ"){

$OSCustomization = Get-OSCustomizationSpec -Name "Server_2019/2022_Template_DMZ"

$ChosenDNS = $DMZDNS

}

if($ChosenDomain -eq "Internal"){

$OSCustomization = Get-OSCustomizationSpec -Name "Server_2019/2022_Template_NET"

$ChosenDNS = $InternalDNS

}

Get-OSCustomizationSpec -Name Temp | Remove-OSCustomizationSpec -confirm:$false -ErrorAction Ignore | Out-Null

Get-OSCustomizationSpec -Name $OSCustomization | New-OSCustomizationSpec -Name Temp -Type NonPersistent | Set-OSCustomizationSpec -NamingScheme vm | Out-Null

Get-OSCustomizationSpec -Name Temp | Get-OSCustomizationNicMapping | Set-OSCustomizationNicMapping -IpMode UseStaticIP -IpAddress $ChosenIP -SubnetMask $ChosenMask -DefaultGateway $ChosenGateway -Dns $ChosenDNS.IP4Address | Out-Null

$ChosenCustomization = Get-OSCustomizationSpec -Name Temp

#Select VM Cluster

#Deploy VM

$FolderName = $FolderPathStart+"/"+$ChosenDivision

$ChosenFolder = Get-FolderByPath -Path $FolderName

New-VM -Name $ChosenName -Template $ChosenTemplate -OSCustomizationSpec $ChosenCustomization -Datastore $ChosenDatastore -Location $ChosenFolder -NetworkName $ChosenNetwork -VMHost $ChosenHost -ResourcePool $ChosenCluster | Out-Null

Set-VM -VM $ChosenName -NumCpu $ChosenSockets -CoresPerSocket $ChosenCores -MemoryGB $ChosenMemory -Notes $ChosenNotes -Confirm:$false | Out-Null

Set-Annotation -Entity $ChosenName -CustomAttribute "Environment" -Value $ChosenEnvironment | Out-Null

Set-Annotation -Entity $ChosenName -CustomAttribute "Business Division" -Value $ChosenDivision| Out-Null

Set-Annotation -Entity $ChosenName -CustomAttribute "Created Date" -Value $CurrentDate | Out-Null

Set-Annotation -Entity $ChosenName -CustomAttribute "Creator" -Value $ChosenCreator | Out-Null

Set-Annotation -Entity $ChosenName -CustomAttribute "Domain" -Value $ChosenDomain | Out-Null

Set-Annotation -Entity $ChosenName -CustomAttribute "Owner" -Value $ChosenOwner | Out-Null

Set-Annotation -Entity $ChosenName -CustomAttribute "Server Function" -Value $ChosenFunction | Out-Null

Set-Annotation -Entity $ChosenName -CustomAttribute "HD Event" -Value $ChosenHDEvent | Out-Null

Start-VM -VM $ChosenName | Out-Null

#Ensure VM is ready to go.

#Options:

#Get-ADComputer returns a non-error. Requires unique name, which can be checked for and possibly deleted at beginning of script.

#Time delay.

#Modify Windows settings

#Update VMTools

#Update OS

LucD · ‎07-19-2022

You can not add a Tag to "... entity that is yet to be created"

Not sure how you coded the creation of the VM, but a New-VM cmdlet returns an object which you can then use on the New-TagAssigment cmdlet as the value for the Entity parameter.

Blog: lucd.info Twitter: @LucD22 Co-author PowerCLI Reference

aplechaty · ‎07-19-2022

Here is the existing script. I added the Backup type variables just need to know if I can add the tag at some point so we don't have to do so after the fact.

#Variables

$VCenterServer = "myvcenter.mydomain.net"

$Environments = "PROD","DEV"

$BusinessDivisions = "Corporate","DevOps","EA","ECM","EDI","Network Services","RCO","RCS"

$ServerFunctions = "Application","Web","Database","File","Management"

$DMZDomain = "domain.dmz"

$InternalDomain = "domain.net"

$DMZDNS = Resolve-DnsName -Type NS -Name $DMZDomain

$InternalDNS = Resolve-DnsName -Type NS -Name $InternalDomain

$IPPattern = "^([1-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])(\.([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])){3}$"

$CurrentDate = Get-Date -Format d

$BackupTag = "DomainControllers","DEV-2-Week-Linux","DEV-2-Week-Windows","DEV-4-Week-Linux","DEV-4-Week-Windows","PROD-2-Week-Linux","PROD-2-Week-Windows",'PROD-4-Week-Linux","PROD-4-Week-Windows"

#Functions

#Quick function to give the user a prompt of specific options.

function Get-UserPrompt {

param (

[Parameter(Mandatory=$true)]

[string[]]$Options,

[Parameter(Mandatory=$true)]

[string]$Prompt

)

[int]$Response = 0;

[bool]$ValidResponse = $false

while (!($ValidResponse)) {

[int]$OptionNo = 0

Write-Host $Prompt -ForegroundColor DarkYellow

Write-Host "[0]: Cancel"

foreach ($Option in $Options) {

$OptionNo += 1

Write-Host ("[$OptionNo]: {0}" -f $Option)

}

if ([Int]::TryParse((Read-Host), [ref]$Response)) {

if ($Response -eq 0) {

return ''

}

elseif($Response -le $OptionNo) {

$ValidResponse = $true

}

return $Options.Get($Response - 1)

}

#Quick function to request specified information.

Function Get-DeploymentVariables{

param(

[Parameter(Mandatory=$true)]

[string]$Prompt

)

Write-Host $Prompt -ForegroundColor DarkYellow

Read-Host

}

#Pull correct folder by specifying the path. Copied directly from: https://www.lucd.info/2012/05/18/folder-by-path/

function Get-FolderByPath{

<#

.SYNOPSIS Retrieve folders by giving a path

.DESCRIPTION The function will retrieve a folder by it's path.

The path can contain any type of leave (folder or datacenter).

.NOTES

Author: Luc Dekens .PARAMETER Path The path to the folder. This is a required parameter.

.PARAMETER

Path The path to the folder. This is a required parameter.

.PARAMETER

Separator The character that is used to separate the leaves in the path. The default is '/'

.EXAMPLE

PS> Get-FolderByPath -Path "Folder1/Datacenter/Folder2"

.EXAMPLE

PS> Get-FolderByPath -Path "Folder1>Folder2" -Separator '>'

#>

param(

[CmdletBinding()]

[parameter(Mandatory = $true)]

[System.String[]]${Path},

[char]${Separator} = '/'

)

process{

if((Get-PowerCLIConfiguration).DefaultVIServerMode -eq "Multiple"){

$vcs = $global:defaultVIServers

}

else{

$vcs = $global:defaultVIServers[0]

}

$folders = @()

foreach($vc in $vcs){

$si = Get-View ServiceInstance -Server $vc

$rootName = (Get-View -Id $si.Content.RootFolder -Property Name).Name

foreach($strPath in $Path){

$root = Get-Folder -Name $rootName -Server $vc -ErrorAction SilentlyContinue

$strPath.Split($Separator) | ForEach-Object{

$root = Get-Inventory -Name $_ -Location $root -NoRecursion -Server $vc -ErrorAction SilentlyContinue

if((Get-Inventory -Location $root -NoRecursion | Select-Object -ExpandProperty Name) -contains "vm"){

$root = Get-Inventory -Name "vm" -Location $root -Server $vc -NoRecursion

}

$root | Where-Object {$_ -is [VMware.VimAutomation.ViCore.Impl.V1.Inventory.FolderImpl]}|ForEach-Object{

$folders += Get-Folder -Name $_.Name -Location $root.Parent -NoRecursion -Server $vc

}

$folders

}

#Connect to VCenter Server. Will prompt for credentials.

Connect-VIServer $VCenterServer

#Prompts for all variables.

#PROD/DEV/QA/TEST.

$ChosenEnvironment = Get-UserPrompt -Options $Environments -Prompt "Choose Environment."

if($ChosenEnvironment -eq "PROD"){

$ChosenHost = Get-VMHost -Location "mydomain Production" | Sort-Object MemoryUsageGB -Descending | Select-Object -Last 1

$FolderPathStart = "mydomain Production/"

$ChosenCluster = Get-Cluster -Name "mydomain Production"

}

if($ChosenEnvironment -eq "DEV"){

$ChosenHost = Get-VMHost -Location "mydomain Development" | Sort-Object MemoryUsageGB -Descending | Select-Object -Last 1

$FolderPathStart = "mydomain Development/"

$ChosenCluster = "mydomain Development"

$ChosenCluster = Get-Cluster -Name "mydomain Development"

}

#Business Division

$ChosenDivision = Get-UserPrompt -Options $BusinessDivisions -Prompt "Choose Business Division."

#VM Notes

$ChosenNotes = Get-DeploymentVariables -Prompt "Enter VM Notes"

#Server Owner

$ChosenOwner = Get-DeploymentVariables -Prompt "Enter Server Owner"

#Server Function

$ChosenFunction = Get-UserPrompt -Options $ServerFunctions -Prompt "Choose Server Function"

#Creator

$ChosenCreator = Get-DeploymentVariables -Prompt "Enter Your Name"

#HD Event

$ChosenHDEvent = Get-DeploymentVariables -Prompt "Enter HD Event Number"

#Domain.

$ChosenDomain = Get-UserPrompt -Options ("DMZ","Internal") -Prompt "Choose Domain."

#OS.

$ChosenOS = Get-UserPrompt -Options ("2019","2022") -Prompt "Choose OS."

if($ChosenOS -eq "2019"){

$ChosenTemplate = Get-Template -Name "SRV2019_Template"

}

if($ChosenOS -eq "2022"){

$ChosenTemplate = Get-Template -Name "SRV2022_Template"

}

#Name.

$ChosenName = Get-DeploymentVariables -Prompt "Enter Server Name"

#Network. This may need to change when we switch to distributed switches.

$VMNetworks = Get-VirtualPortGroup | Sort-Object Name | Get-Unique

$ChosenNetwork = Get-UserPrompt -Options $VMNetworks -Prompt "Choose Network."

Do{

$ChosenIP = Get-DeploymentVariables -Prompt "Enter IP Address."

$IPTest = $null

$IPTest = Test-Connection $ChosenIP -ErrorAction Ignore

$IPCheck = $ChosenIP -match $IPPattern

if($IPCheck -eq $true){

if($null -ne $IPTest){

Write-Host "IP is already in use. Try again." -ForegroundColor Red

}}

if($IPCheck -eq $false) {

Write-Host "Invalid IP address. Please try again." -ForegroundColor Red

}

Until ($null -eq $IPTest -and $IPCheck -eq $true)

Do{

$ChosenMask = $null

$ChosenMask = Get-DeploymentVariables -Prompt "Enter Subnet Mask."

$MaskCheck = $ChosenMask -match $IPPattern

If($MaskCheck -eq $false){

Write-Host "Invalid Subnet Mask. Try again." -ForegroundColor Red

}

Until ($MaskCheck -eq $true)

Do{

$ChosenGateway = $null

$ChosenGateway = Get-DeploymentVariables -Prompt "Enter Gateway."

$GatewayCheck = $ChosenGateway -match $IPPattern

If($GatewayCheck -eq $false){

Write-Host "Invalid gateway, try again." -ForegroundColor Red

}

Until ($GatewayCheck -eq $true)

#Datastore.

if($ChosenEnvironment -eq "DEV"){

$Datastores = Get-DatastoreCluster -Location "mydomain Development" | Select-Object Name

$ChosenDatastore = Get-UserPrompt -Options $Datastores.Name -Prompt "Choose Datastore"

}

if($ChosenEnvironment -eq "PROD"){

$Datastores = Get-DatastoreCluster -Location "mydomain Production" | Select-Object Name