New-TagCategory

This cmdlet creates a new tag category on the specified vCenter Server systems with the specified parameters.

Syntax

-Name  <String>
[-Cardinality  <Cardinality>]
[-Description  <String>]
[-EntityType  <String[]>]
[-Server  <VIServer[]>]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
Name
String named Specifies the name of the new tag category.
optional
Cardinality
Cardinality named Specifies the cardinality of the tag category. If not specified, the default value is "Single".
optional
Description
String named Specifies the description of the new tag category.
optional
EntityType
String[] named Defines the type of objects to which the tags in this category will be applicable. If you do not specify this parameter or specify "All" as a value, the tags in this category will be applicable to all valid entity types.
optional
Server
VIServer[] named
  • wildcards
  • pipeline
  • Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer.

    Output

    VMware.VimAutomation.ViCore.Types.V1.Tagging.TagCategory

    Examples


    Example 1

    New-TagCategory -Name "MyTagCategory" -Cardinality "Single" -EntityType "VirtualMachine"

    Creates a new tag category, named "MyTagCategory", defining the "VirtualMachine" type as applicable to the tags inside that category and specifying that only a single tag from that category can be assigned to a specific VirtualMachine object at a time.

    Example 2

    New-TagCategory -Name "MyTagCategory" -Cardinality "Multiple" -Description "MyTagCategory description"

    Creates a new tag category, named "MyTagCategory", that has "MyTagCategory description" set as a description and specifies that multiple tags from that category can be assigned to an object. Tags from this category are applicable to all valid entity types.

    Related Commands

    Feedback

    Was this page helpful?