Tag Category | Vmware PowerCLI Reference

Tag Category

Cmdlets are usually implemented around resource operations. The four basic operations are CREATE, READ, UPDATE and DELETE. This set of operations is known as CRUD. Most of the cmdlets support CRUD which are respectively cmdlets that start with the New/Get/Set/Remove cmdlet verbs but they also may have additional operations

Step 1: Retrieve a object by running a Get command

You can READ objects by using Get-Tag cmdlet. See example below:

# Returns all tags named "MyTag".

Get-Tag -Name "MyTag"

Step 2 : Run commands from the CRUD group

You can CREATE objects by using New-Tag cmdlet. See example below:

# Retrieves a specific tag category, named "MyTagCategory", creates a tag named "MyTag" inside it, and sets the tag description.

Get-TagCategory -Name "MyTagCategory" | New-Tag -Name "MyTag" -Description "Create MyTag tag in MyTagCategory category."
You can UPDATE objects by using Set-Tag cmdlet. See example below:

# Retrieves a tag named "MyTag" and updates its name and description.

Get-Tag -Name "MyTag" | Set-Tag -Name "MyNewTag" -Description "MyNewDescription"
You can REMOVE objects by using Remove-Tag cmdlet. See example below:

# Retrieves the tags named "MyTag1" and "MyTag2" from the specified tag category named "MyTagCategory" and then removes the tags from the vCenter Server system.

$tagCategory = Get-TagCategory "MyTagCategory" Get-Tag -Name "MyTag1", "MyTag2" -Category $tagCategory | Remove-Tag

Step 3: Explore More Related Commands:

Get-TagAssignment This cmdlet retrieves the tag assignments of objects.
Get-TagCategory This cmdlet retrieves the tag categories available on a vCenter Server system and filters them using the specified cmdlet parameters.
New-TagAssignment This cmdlet assigns the specified tag(s) to the specified entity(s).
New-TagCategory This cmdlet creates a new tag category on the specified vCenter Server systems with the specified parameters.
Remove-TagAssignment This cmdlet removes the specified tag assignment.
Remove-TagCategory This cmdlet removes the specified tag categories from the server.
Set-TagCategory This cmdlet modifies the specified tag categories.