Product documentation

Citrix DaaS

View PDF

Tags

November 9, 2022

Contributed by:

C R

Introduction

Tags are strings that identify items such as machines, applications, desktops, delivery groups, application groups, and policies. After creating a tag and adding it to an item, you can tailor certain operations to apply only to items that have a specified tag.

Tailor search displays in the Full Configuration management interface.
For example, to display only applications that have been optimized for testers, create a tag named “test” and then add (apply) it to those applications. You can now filter the search with the tag “test”.
Publish applications from an application group or specific desktops from a delivery group, considering only a subset of the machines in selected delivery groups. This is called atag restriction。
With tag restrictions, you can use your existing machines for more than one publishing task, saving the costs associated with deploying and managing more machines. A tag restriction can be thought of as subdividing (or partitioning) the machines in a delivery group. Its functionality is similar, but not identical, to worker groups in XenApp releases earlier than 7.x.
Using an application group or desktops with a tag restriction can be helpful when isolating and troubleshooting a subset of machines in a delivery group.
Details and examples of using a tag restriction are described later in this article.
年代chedule periodic restarts for a subset of machines in a delivery group.
Using a tag restriction for machines enables you to use new PowerShell cmdlets to configure multiple restart schedules for subsets of machines in a delivery group. For examples and details, seeManage delivery groups。
Tailor the application (assignment) of Citrix policies to machines in delivery groups, delivery group types, or OUs that have (or don’t have) a specified tag.
For example, if you want to apply a Citrix policy only to the more powerful workstations, add a tag named “high power” to those machines. Then, on theAssign Policypage of the Create Policy wizard, select that tag and theEnablecheck box. You can also add a tag to a delivery group and then apply a Citrix policy to that group. For details, seeCreate policies。

You can apply tags to:

Machines
Applications
Machine catalogs
Delivery groups
Application groups

You can configure a tag restriction when creating or editing the following in the Full Configuration management interface:

A desktop in a shared delivery group
An application group

Tag restrictions for a desktop or an application group

A tag restriction involves several steps:

Create the tag and then add (apply) it to machines.
Create or edit a group with the tag restriction (in other words, restrict launches to machines with tagx).

A tag restriction extends the Controller’s machine selection process. The Controller selects a machine from an associated delivery group, subject to access policy, configured user lists, zone preference, and launch readiness, plus the tag restriction (if present). For applications, the Controller falls back to other delivery groups in priority order, applying the same machine selection rules for each considered delivery group.

Example 1: Simple layout

This example introduces a simple layout that uses tag restrictions to limit which machines are considered for certain desktop and application launches. There is one shared delivery group, one published desktop, and one application group configured with two applications.

Example using tag restrictions in a simple layout.

Tags have been added to each of the three machines (VDA 101-103).
的desktop in the delivery group was created with a tag restriction namedRed。年代o, that desktop can be launched only on machines in that delivery group that have the tagRed: VDA 101 and 102.
的application group was created with theOrangetag restriction. So, each of its applications (CalculatorandNotepad) can be launched only on machines in that delivery group that have the tagOrange: VDA 102 and 103.

Machine VDA 102 has both tags (RedandOrange), so it can be considered for launching the applications and the desktop.

Example 2: More complex layout

This example contains several application groups that were created with tag restrictions. This results in the ability to deliver more applications with fewer machines than would otherwise be needed if you used only delivery groups.

How to configure example 2shows the steps used to create and apply the tags, and then configure the tag restrictions in this example.

Example using tag restrictions in a complex layout.

This example uses 10 machines (VDA 101-110), one delivery group (D01), and three application groups (A100,A200,A300). By applying tags to each machine and then specifying tag restrictions when creating each application group:

Accounting users in the group can access the apps they need on five machines (VDA 101–105)
CAD designers in the group can access the apps they need on five machines (VDA 106-110)
Users in the group who need Office applications can access the Office apps on 10 machines (VDA 101-110)

Only 10 machines are used, with only one delivery group. Using delivery groups alone (without application groups) would require twice as many machines, because a machine can belong to only one delivery group.

Manage tags and tag restrictions

Tags are created, added (applied), edited, and deleted from selected items through theManage Tagsaction in the Full Configuration management interface.

(Exception: Tags used for policy assignments are created, edited, and deleted through theManage Tagsaction. However, you apply (assign) tags when you create the policy. SeeCreate policiesfor details.)

Tag restrictions are configured when you create or edit desktops in delivery groups, and when you create and edit application groups.

Use the Manage Tags feature

FromManage > Full Configuration, select the items to which you want to apply a tag. The items include:

One or more machines
One or more applications
德一个桌面livery group, or an application group
A machine catalog

的n selectManage Tagsin the action bar. TheManage Tagsdialog box lists all existing tags, not just those for the items you selected.

An enabled check box indicates that the tag has already been added to the selected items. (In the screen capture below, the selected machine has a tag named “Tag1” applied.)
If you select more than one item, a check box containing a hyphen indicates that some but not all selected items have that tag added.

Manage Tags dialog box

的following actions are available from theManage Tagsdialog box. ReviewCautions when working with tags。

To create a tag:
年代electCreate.Enter a name and description. Tag names must be unique and are not case-sensitive. Then select年代ave。
Creating a tag does not automatically apply it to any items you have selected. Use the check boxes to apply the tag.
To add (apply) one or more tags:
Enable the check box next to the tag name. A check box containing a hyphen indicates that some, but not all selected items already have the tag applied. When you select multiple items and a tag’s check box has a hyphen, changing it to a check mark affects all selected machines.
If you attempt to add a tag to machines, and that tag is used as a restriction in an application group, you are warned that the action can make those machines available for launch. If that’s what you intend, proceed.
To remove one or more tags:
Clear the check box next to the tag name. A check box containing a hyphen indicates that some, but not all selected items already have the tag applied. When you select multiple items and a tag’s check box has a hyphen, clearing the check box removes the tag from all selected machines.
If you try to remove a tag restriction from a machine, you’re warned that the action can affect the machines considered for launch. If that’s what you intend, proceed.
To edit a tag:
年代elect a tag and then selectEdit。Enter a new name, description, or both. You can edit only one tag at a time.
To delete one or more tags:
年代elect the tags and then select删除。的删除Tagdialog box indicates how many items currently use the selected tags (for example “2 machines”). Select an item to display more information (for example, the names of the two machines that have the tag applied). Confirm whether you want to delete the tags.
You cannot delete a tag that is used as a restriction. First, edit the application group and remove the tag restriction or select a different tag.

When you’re done in theManage Tagsdialog box, select年代ave。

To see if a machine has any tags applied: SelectDelivery Groupsin the left pane. Select a delivery group then selectView Machinesin the action bar. Select a machine and then select theTagstab on theDetailspane.

Manage tag restrictions

Configuring a tag restriction is a multi-step process: You first create the tag and add/apply it to machines. Then, you add the restriction to the application group or the desktop.

Create and apply the tag:
Create the tag and then add (apply) it to the machines that the tag restriction will affect, usingManage Tagsactions.
To add a tag restriction to an application group:
Create or edit the application group. On theDelivery Groupspage, selectRestrict launches to machines with the tagand then select the tag from the list.
To change or remove the tag restriction on an application group:
Edit the group. On theDelivery Groupspage, either select a different tag from the list or remove the tag restriction entirely by clearingRestrict launches to machines with the tag。
To add a tag restriction to a desktop:
Create or edit a delivery group. SelectAddorEditon the台式电脑page. In theAdd Desktopdialog box, selectRestrict launches to machines with the tagand then select the tag from the menu.
To change or remove the tag restriction on a delivery group:
Edit the group. On the台式电脑page, selectEdit。In the dialog box, either select a different tag from the list or remove the tag restriction entirely by clearingRestrict launches to machines with the tag。

Cautions when working with tags

A tag applied to an item can be used for different purposes. Keep in mind that adding, removing, and deleting a tag can have unintended effects. You can use a tag to sort machine displays when using search in the Full Configuration management interface. You can use the same tag as a restriction when configuring an application group or a desktop. That action limits launch consideration to only machines in specified delivery groups that have that tag.

If you add a tag to machines after that tag is configured as a desktop or application group tag restriction, you are warned that might make the machines available for launching more applications or desktops. If that’s what you intend, proceed. If not, cancel the operation.

For example, let’s say you create an application group with theRedtag restriction. Later, you add several other machines in the same delivery groups used by that application group. If you then try to add theRedtag to those machines, you see a message similar to: “The tagRed作为限制以下美联社吗plication groups. Adding this tag might make the selected machines available to launch applications in this application group.” You can then confirm or cancel adding that tag to those additional machines.

年代imilarly, when a tag is used in an application group to restrict launches, you cannot delete the tag until you edit the group and remove it as a restriction. (If you were allowed to delete that tag, it might result in allowing applications to launch on all machines in the delivery groups associated with the application group.) The same prohibition against deleting a tag applies if the tag is being used as a restriction for desktop launches. After you edit the application group or desktops in the delivery group to remove that tag restriction, you can delete the tag.

All machines might not have the same sets of applications. A user can belong to more than one application group, each with a different tag restriction and different or overlapping sets of machines from delivery groups. The following table lists how machine considerations are decided.

When an application has been added to	的se machines in the selected delivery groups are considered for launch
One application group with no tag restriction	Any machine.
One application group with tag restriction A	Machines that have tag A applied.
Two application groups, one with tag restriction A and the other with tag restriction B	Machines that have tag A and tag B. If none is available, then machines that have tag A or tag B.
Two application groups, one with tag restriction A and the other with no tag restriction	Machines that have tag A. If none is available, then any machine.

If you used a tag restriction in a machine restart schedule, any changes you make that affect tag applications or restrictions affect the next machine restart cycle. It does not affect any restart cycles that is in progress while the changes are being made.

How to configure example 2

的following sequence shows the steps to create and apply tags, and then configure tag restrictions for the application groups illustrated in the earlier second example.

VDAs and applications have already been installed on the machines and the delivery group has been created.

Create and apply tags to the machines:

FromManage > Full Configuration, selectDelivery Groupsin the left pane. Select delivery groupD01and then selectView Machinesin the action bar.
年代elect machines VDA 101-105 and then selectManage Tagsin the action bar.
In theManage Tagsdialog box, selectCreate。Create a tag namedCADApps。年代electOK。
年代electCreateagain and create a tag namedOfficeApps。年代electOK。
Add (apply) the newly created tags to the selected machines by enabling the check boxes next to each tag’s name (CADAppsandOfficeApps). Then close the dialog box.
年代elect delivery groupD01。年代electView Machinesin the action bar.
年代elect machines VDA 106-110 and then selectManage Tagsin the action bar.
In theManage Tagsdialog box, selectCreate。Create a tag namedAcctgApps。年代electOK。
Apply the newly createdAcctgAppstag and theOfficeAppstag to the selected machines by selecting the check boxes next to each tag’s name. Then close the dialog box.

Create the application groups with tag restrictions.

FromManage > Full Configuration, selectApplicationsin the left pane.
年代electCreate Application Groupin the action bar. The wizard launches.
On theDelivery Groupspage, select delivery groupD01。年代electRestrict launches to machines with tagand then select theAcctgAppstag from the list.
Complete the wizard, specifying the accounting users and the accounting applications. (When adding the application, choose theFrom Start menusource, which searches for the application on the machines that have theAcctgAppstag.) On the年代ummarypage, name the groupA100。
Repeat the preceding steps to create application groupA200, specifying machines that have theCADAppstag, plus the appropriate users and applications.
Repeat steps to create application groupA300, specifying machines that have theOfficeAppstag, plus the appropriate users and applications.

Apply tags to machine catalogs

You can useManage > Full Configurationor PowerShell to apply tags to machine catalogs.

Using the management interface is described inManage tags。Catalog displays do not indicate whether tags are applied.
To use PowerShell, seeUse PowerShell to apply tags to catalogs。

Here is an example of using tags with catalogs:

A delivery group contains machines from several catalogs, but you want an operation (such as a restart schedule) to affect only the machines in a specific catalog. Applying a tag to that catalog accomplishes that goal.

Use PowerShell to apply tags to catalogs

的following PowerShell cmdlets are available:

You can pass catalog objects to cmdlets such asAdd-BrokerTagandRemove-BrokerTag。
Get-BrokerTagUsageshows how many catalogs contain tags.
Get-BrokerCataloghas a property namedTags。

For example, the following cmdlets add a previously created tag namedfy2018to the catalog namedacctg:Get-BrokerCatalog -Name acctg | Add-BrokerTag fy2018。

年代ee the PowerShell cmdlet help for guidance and syntax.