Private/Set-TagEC2.ps1

<#
# Copyright (c) 2021 All Rights Reserved by the RWS Group for and on behalf of its affiliates and subsidiaries.
#
# 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
   Set the tag for EC2 instance
.DESCRIPTION
   With the assumption that the operating system is hosted on AWS EC2, set the tag for EC2 instance
.EXAMPLE
   Set-TagEC2 -Name name
.EXAMPLE
   Set-TagEC2 -Name name -Value value
#>

function Set-TagEC2 {
   [CmdletBinding()]
   param (
      [Parameter(Mandatory = $true)]
      [string]$Name,
      [Parameter(Mandatory = $false)]
      $Value = $null
   )

   begin {
   }

   process {
      Write-Debug "Querying the metada endpoint"
      $instanceId = Get-EC2InstanceMetadata -Category InstanceId
      Write-Debug "instanceId=$instanceId"

      $tag = New-Object Amazon.EC2.Model.Tag
      $tag.Key = $Name
      $tag.Value = $Value
      Write-Debug "Tag=$tag"

      New-EC2Tag -Resource $instanceId -Tag $tag
   }

   end {

   }
}