Scribd
Upload
180 views4 pages

How To Update Master Image For Dedicated and Pooled MCS Catalog Using PowerShell SDK

This document provides instructions for updating the master image for dedicated and pooled MCS catalogs using PowerShell SDK. It describes taking a snapshot of the modified virtual machine, getting provisioning scheme details including the current master image path, and running commands to publish the new snapshot path to update the master image. Running Publish-ProvMasterVmImage updates the master image and displays the results.

Uploaded by

Sanjay Basu
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as DOCX, PDF, TXT or read online on Scribd
180 views4 pages

How To Update Master Image For Dedicated and Pooled MCS Catalog Using PowerShell SDK

This document provides instructions for updating the master image for dedicated and pooled MCS catalogs using PowerShell SDK. It describes taking a snapshot of the modified virtual machine, getting provisioning scheme details including the current master image path, and running commands to publish the new snapshot path to update the master image. Running Publish-ProvMasterVmImage updates the master image and displays the results.

Uploaded by

Sanjay Basu
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as DOCX, PDF, TXT or read online on Scribd
You are on page 1/ 4

How to update Master Image for

Dedicated and Pooled MCS Catalog


using PowerShell SDK
Applicable Products
 Citrix Virtual Apps
 Citrix Virtual Desktops
 Citrix Virtual Apps and Desktops
 XenDesktop

Objective
This article describes how to update the master image for Dedicated and Pooled MCS
catalogs using PowerShell Software Development Kit (PowerShell SDK)

Background

The GUI option Update Machine is available only for the Pooled MCS catalogs. This
option is not available for Dedicated MCS catalogs.

You can't update a Dedicated Catalog through Studio. That would cause the Dedicated
machines to be reset.
 
You can either re-create that catalog as Random (or discard).

Instructions
Note: Changes applied to the master image of a Dedicated Catalog takes effect only for
the new machines created from the image. These changes are not applied to the
existing machines in the Catalog.

1. Modify the master Virtual Machine or new virtual machine with the required
changes.
2. Take a snapshot of the modified virtual machine.
3. Start PowerShell on Delivery Controller (Controller).
4. Run command Add-PSSnapIn citrix*.
5. Run command Get-ProvScheme.

This displays a list of Provisioning Scheme(s) from the XenDesktop site. Make a
note of the MasterImageVM entry.
Example

ProvisioningSchemeUid : 2a01126c-0352-41e0-9603-9118120e15c3
ProvisioningSchemeName : win7ded_anu
.
.
MasterImageVM : XDHyp:\HostingUnits\anu\Anu- Win7.vm\existing.snapshot\
Citrix_XD_win7-pooled.snapshot\Citrix_XD_win7-pooled.snapshot\sp1.snapshot\
248813.snapshot
MasterImageVMDate : 4/14/2011 6:01:21 PM
IdentityPoolUid : 1d227066-f5ee-41b9-8a99-753e9d060e42
IdentityPoolName : win7ded
HostingUnitUid : d534c437-6c65-4659-97db-d6b86534685b
HostingUnitName : anu
.
.
VMMetadata : {A, A, E, A...}
Note: This preceding information is also required for reverting to the previous
image.

6. Run the following command to display the list of snapshots on the virtual
machine:

Get-ChildItem -Recurse -Path 'XDHyp:\hostingunits\%hostName%\


%vmName%.vm'

Example

Get-ChildItem -Recurse -Path 'XDHyp:\hostingunits\anu\Anu-Win7.vm

Where, hostname is anu and vmname is Anu-win7.

Output

PSPath : Citrix.Host.Admin.V1\Citrix.Hypervisor::XDHyp:\hostingunits\
anu\Anu- Win7.vm\existing.snapshot\Citrix_XD_win7-pooled.snapshot\
Citrix_XD_win7- pooled.snapshot\sp1.snapshot\2505438.snapshot\
afterupdate.snapshot
PSParentPath : Citrix.Host.Admin.V1\Citrix.Hypervisor::XDHyp:\hostingunits\
anu\Anu-
Win7.vm\existing.snapshot\Citrix_XD_win7-pooled.snapshot\Citrix_XD_win7-
pooled.snapshot\sp1.snapshot\2505438.snapshot
PSChildName : afterupdate.snapshot
.
.
ObjectPath : /Anu-Win7.vm/existing.snapshot/Citrix_XD_win7-
pooled.snapshot/Citrix_XD_win7-pooled.snapshot/sp1.snapshot/2505438.snapshot/
afterupdate.snapshot
FullPath : XDHyp:\hostingunits\anu\Anu-Win7.vm\existing.snapshot\
Citrix_XD_win7- pooled.snapshot\Citrix_XD_win7- pooled.snapshot\sp1.snapshot\
2505438.snapshot\afterupdate.snapshot
IsSymLink : False
AdditionalData : {}

7. Run the following command to publish the details of the master virtual machine:

Publish-ProvMasterVmImage -ProvisioningSchemeName
"%provisioningSchemeName%" -MasterImageVM "%templatePSPath%"

Example

Publish-ProvMasterVmImage -ProvisioningSchemeName win7ded_anu –


masterimagevm XDHyp:\hostingunits\anu\Anu-Win7.vm\existing.snapshot\
Citrix_XD_win7- pooled.snapshot\Citrix_XD_win7-pooled.snapshot\
sp1.snapshot\2505438.snapshot\afterupdate.snapshot

Where %provisioningSchemeName% is win7ded_anu and %templatePSPath%


is XDHyp:\hostingunits\anu\Anu-Win7.vm\existing.snapshot\
Citrix_XD_win7- pooled.snapshot\Citrix_XD_win7- pooled.snapshot\
sp1.snapshot\2505438.snapshot\afterupdate.snapshot.

The preceding command updates the master image and displays the result.

Output
 

TaskId : c6b5acf4-f950-428c-82a4-0150dab99945
Active : False
Host : XX-W2K8R2-DDC
DateStarted : 4/15/2011 5:01:44 PM
Type : PublishImage
Metadata : {}
WorkflowStatus : Completed
ProvisioningSchemeUid : 2a01126c-0352-41e0-9603-9118120e15c3
ProvisioningSchemeName : win7ded_anu

MasterImage : XDHyp:\HostingUnits\anu\Anu- Win7.vm\


existing.snapshot\Citrix_XD_win7-pooled.snapshot\Citrix_XD
_win7- pooled.snapshot\sp1.snapshot\
2505438.snapshot\afterupdate.snapshot
HostingUnitName : anu
HostingUnitUid : d534c437-6c65-4659-97db-d6b86534685b
ADIdentityPoolName :

ADIdentityPoolUid : 1d227066-f5ee-41b9-8a99-753e9d060e42

TaskState : Finished
TaskStateInformation :
TaskProgress : 100
DiskSize : 24
The following confirmation message appears in the Citrix Studio action pane:

You might also like