Versions Compared

Version Old Version 7 New Version 8
Changes made by

wiki

wiki

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Activities

...

 

 

 

Get Registration State

This activity returns the registration state of the specified machine catalog.

Activity Parameters

The Get Registration State activity parameters can be provided by manual inserted values or via IN arguments or variables:

All of the input parameters are mandatory.

Parameters:

  • Catalog Name (text box editor type) (type: string): the name of the catalog from which you want to return information about the machines and their registration state.
 

The Read Only Output variable are the possible output values that the activity will provide:

  • Output Machines (type: collection<Dictionary<string,string>>): outputs a collection of dictionaries containing the machine names and their registration states.In order to use the output you can use the GetKeyValuePair activity with the keys:  MachineName, CatalogName and RegistrationState in an iteration activity.

 

Execution: The example below is an execution where the machines from catalog MCS_ByWF catalog are returned and key values MachineName and RegistrationState are extracted.

 

In order to extract the values from the output parameter, For Each and GetKeyValuePair activities are used to extract the key values for  MachineName and RegistrationState keys:

 



Get Machines

This activity retrieves servers from the specified worker group or delivery group.

Activity Parameters

The Get Machines activity parameters can be provided by manual inserted values or via IN arguments or variables:

Parameters:

  • CatalogName (text box editor type) (type: string): the name of the catalog that contains the machines to be retrieved. 
  • DesktopGroup Name (text box editor type) (type: string): the name of the desktop group that contains the machine(s) you wish to retrieve.

NOTE. CatalogName and DesktopGroupName parameters are used to filter the results returned by this activity. 

 

 

The Read Only Output variable are the possible output values that the activity will provide:

  • Output (type: collection<psobject>): outputs a collection of PSObjects that represents the machines(s) retrieved. This can be used as an input for other activities that expect a collection of BrokerMachine objects.
  • Output Count (type: int32): outputs the number of the machines retrieved.
  • Output Machines Collection (type: collection<collection<KeyValuePair<String,String>>>): outputs a collection of collections containing the BrokerMachine Type items with their properties. To use the elements of the collection, use the 'Get KeyValuePair' activity.

 

In order to extract the values from the OutputMachines output parameter, For Each and GetKeyValuePair activities are used to extract the key value for  MachineName key:

 

 

Execution:

Get Sessions

This activity retrieves the user sessions.

Activity Parameters

The Get Sessions activity parameters can be provided by manual inserted values or via IN arguments or variables:

All of the input parameters are mandatory.

Parameters:

  • UserName (text box editor type) (type: string): the username for the session. For example, 'MyDomain\MyUsername'. 
 

 

The Read Only Output variable are the possible output values that the activity will provide:

  • Output (type: collection<psobject>): outputs a collection of PSObjects that represents the session(s) retrieved. This can be used as an input for other activities that expect a collection of BrokerSession objects.
  • Output Count (type: int32): outputs the number of the sessions retrieved.
  • Output Sessions Collection (type: collection<collection<KeyValuePair<String,String>>>): outputs a collection of collections containing the BrokerSession Type items with their properties. To use the elements of the collection, use the 'Get KeyValuePair' activity.

 

In order to extract the values from the OutputSessions output parameter, For Each and GetKeyValuePair activities are used to extract the first key value:

 

 

Get Snapshot Path

This activity returns the Master Image VM for the specified MCS Machine Catalog.

Activity Parameters

The Get Snapshot Path activity parameters can be provided by manual inserted values or via IN arguments or variables:

All of the input parameters are mandatory.

Parameters:

  • Catalog Name (text box editor type) (type: string): the name of the catalog. 
 

 

The Read Only Output variable are the possible output values that the activity will provide:

  • Output Master Image VM(type: string): outputs a string containing the path of the master image vm for the desired catalog. The result of this activity may be used as input for all Snapshot Path type parameters under Citrix XenDesktop category. 

 

Execution: the activity will return the snapshot path for the master image of the MCS_ByWF catalog:

 

 

List AppDisks

This activity lists all the AppDisks found.  

Activity Parameters

The List AppDisks activity parameters can be provided by manual inserted values or via IN arguments or variables:


Parameters:

  • Connection (text box editor type) (type: object): the output from Connect To XenDesktop activity should be used as Input here. 
     

The Read Only Output variable are the possible output values that the activity will provide:

  • Output (type: collection<PSObject>): outputs a collection of type Collection<System.Management.Automation.PSObject> that represents the AppDisk(s) retrieved. This can be used as input for the other activities that expect a collection of AppDisk objects. 
  • Output AppDisks Collection (type: collection<collection<KeyValuePair<string,string>>>): outputs a collection of collections containing the AppDisk type items with their properties. To use the elements of the collection, use the 'Get KeyValuePair' activity with the keys: 'AppDiskUid' , 'AppDiskName' , 'Description' , 'HostingUnitName' , etc. 
  • Output Count (type: Int32): outputs the number of AppDisks retrieved. 

In order to extract the values from the 'Output AppDisks Collection' output parameter, For Each and GetKeyValuePair activities are used to extract the key 'AppDiskName' value:

 


Execution: 


Remove AppDisk

This activity removes the specified AppDisk.   

Activity Parameters

The Remove AppDisk activity parameters can be provided by manual inserted values or via IN arguments or variables:

Parameters:

  • AppDisk Uid (text box editor type) (type: object): specify the AppDisk Uid or use the output 'AppDisk Uid' from the 'Get AppDisk' activity. E.g. '2c852601-477e-4bdb-bb9f-0c5d40a6147f'. 

  • Connection (text box editor type) (type: object): the output from Connect To XenDesktop activity should be used as Input here. 
     

The Read Only Output variable are the possible output values that the activity will provide:

  • Output Status (type: boolean): outputs whether the operation succeeded or not. 

Execution: 


Rollback Machine Update

MCS Machine Catalog

This activity updates the master VM Image of a MCS activity performs a rollback update for the specified Machine Catalog.

Activity Parameters

The Update MCS Machine Catalog The Rollback Machine Update activity parameters can be provided by manual inserted values or via IN arguments or variables:

Image Removed

All of the input parameters are mandatory.Image Added

Input Parameters

Parameters:

  • Catalog Name (text box editor type) (type: string): the name of the catalog. E.g. 'AppCatalog'.

 

Snapshot Path (text box editor type) (type: string): the snapshot path of the master image vm. The accepted format should be written as in the given example:

XDHyp:

The Read Only Output variable are the possible output values that the activity will provide:

  • Output Result (type: boolean): outputs whether the operation succeeded or not.


Update MCS Machine Catalog

This activity updates the master VM Image of a MCS Machine Catalog.

Activity Parameters

The Update MCS Machine Catalog activity parameters can be provided by manual inserted values or via IN arguments or variables:

Image Added

All of the input parameters are mandatory.

Parameters:

  • Catalog Name (text box editor type) (type: string): the name of the catalog. 

  • Snapshot Path (text box editor type) (type: string): the snapshot path of the master image vm. The accepted format should be written as in the given example:

    XDHyp:\HostingUnits\KIVBF_Testing\KIVBF_Master_Testing.vm\KIVBF_Snapshot_Testing.snapshot\WF_KIVBF_Testing.snapshot\WF_KIVBF_Testing.snapshot\Citrix_XD_JustTestingMCSCat.snapshot\Snapshot_WF.snapshot


 The value also can be obtained from the Get Snapshot Path activity:
  • use a Get Snapshot Path activity to extract the Snapshot Path value:
    Image Removed 
  • bind the obtained snapshot path (stored in variable) to the Snapshot Path field from the Update MCS Machine Catalog activity:

          Image Removed

 

The Read Only Output variable are the possible output values that the activity will provide:

  • Output Result (type: boolean): outputs whether the operation succeeded or not.

 

Delete Delivery Group

This activity deletes the specified delivery group.

Activity Parameters

The Delete Delivery Group activity parameters can be provided by manual inserted values or via IN arguments or variables:

 Image Removed

Input Parameters:

 Parameters

...

  • Snapshot Path value:
    Image Added 
  • bind the obtained snapshot path (stored in variable) to the Snapshot Path field from the Update MCS Machine Catalog activity:

          Image Added

 

The Read Only Output variable are the possible output values that the activity will provide:

...

  • Output Result (type: boolean): outputs whether the operation succeeded or not.