VMware PowerCLI for Mirage

New-MirageOsMigration

Synopsis

This cmdlet migrates CVD with the specified base layer, app layer and related info in the Mirage system.

Syntax

New-MirageOsMigration [-CVD] <CvdInfo[]> [-BaseLayer] <BaseLayerInfo> [-AppLayer <AppLayerInfo[]>] [-Domain <String>] [-WorkGroup <String>] [-MachineName <String>] [-OrganizationUnit <String>] [-Password <String>] [-User <String>] [-DownloadOnly] [-Force] [<CommonParameters>]
New-MirageOsMigration [-CVD] <CvdInfo[]> [-BaseLayer] <BaseLayerInfo> [-AppLayer <AppLayerInfo[]>] [-Domain <String>] [-WorkGroup <String>] [-OrganizationUnit <String>] [-Password <String>] [-User <String>] -MachineNamePrefix <String> -MachineNameStartIndex <UInt32> [-DownloadOnly] [-Force] [<CommonParameters>]

Related Commands

Detailed Description

This cmdlet migrates CVD with the specified base layer, app layer and related info in the Mirage system.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
CVDCvdInfo[]Specify the CVD to migrate.truetrue (ByValue, ByPropertyName)
BaseLayerBaseLayerInfoSpecify the base layer for the migration procedure.truefalse
AppLayerAppLayerInfo[]Specify the app layers for the migration procedure.falsefalse
DomainStringSpecify the domain name if you want the CVD to join a domain.falsefalse
DownloadOnlySwitchParameterSpecify if the migration is full or download only.falsefalse
ForceSwitchParameterUsed to tell Mirage PowerCLI ignore warnings.falsefalse
MachineNameStringSpecify the new name for the machine.falsefalse
MachineNamePrefixStringUsed to auto-generate the machine name with a prefix.truefalse
MachineNameStartIndexUInt32Used to auto-generate the machine name with a prefix and a start index. The index is increased by 1 automatically.truefalse
OrganizationUnitStringSpecify the organization unit.falsefalse
PasswordStringSpecify the password of the user that you are using to join the CVD to a domain.falsefalse
UserStringSpecify the user name of the user that you are using to join the CVD to a domain.falsefalse
WorkGroupStringSpecify the WorkGroup name if the CVD is not joining a domain.falsefalse

Return Type

CvdInfo

Notes

Since VMware Mirage 5.3.0. When "DownloadOnly" is set, the cmdlet returns CvdInfo, otherwise it returns MirageOsMigration.

Examples

-------------- Example 1: Migrate the CVD without joining a domain. --------------

New-MirageOsMigration -CVD $cvd -BaseLayer $bl[0] -WorkGroup 'workgroup'

Id Name DeviceId PolicyImageId State OperationProgress UserName Archived
-- ---- -------- ------------- ----- ----------------- -------- --------
cvd-10030 ZUSER1-B1E4390E device-31 policy-1-1.0 Idle 0 ZUSER1-B1E4390E\z... False
cvd-10032 ZUSER1-C46F3A5D device-34 policy-1-1.0 Idle 0 ZUSER1-C46F3A5D\A... False

-------------- Example 2: Migrate the CVD and joins a domain --------------

New-MirageOsMigration -CVD $cvd -BaseLayer $bl[0] -Domain 'TestDomain' -User 'Administrator' -Password 'password'

Id Name DeviceId PolicyImageId State OperationProgress UserName Archived
-- ---- -------- ------------- ----- ----------------- -------- --------
cvd-10030 ZUSER1-B1E4390E device-31 policy-1-1.0 Idle 0 ZUSER1-B1E4390E\z... False
cvd-10032 ZUSER1-C46F3A5D device-34 policy-1-1.0 Idle 0 ZUSER1-C46F3A5D\A... False


Copyright © VMware, Inc. All rights reserved.