Product Documentation

cmdlet 参考

Sep 14, 2015

cmdlet 摘要

要获取 PowerShell 的帮助,请键入 Get-Help cmdlet-name。
  • 要查看示例,请使用 -examples 选项。
  • 要获取详细信息,请使用 -detailed 选项。
  • 要获取技术信息,请使用 -full 选项。

迁移中心 cmdlet 支持 PowerShell 通用参数。具体而言,-Confirm 和 -Verbose 在迁移过程中非常有用。

尽管支持使用 -WhatIf 通用参数,但将 -PendingReportOnly 选项与 Start-XAMigration cmdlet 结合使用可以在迁移预览期间显示更详细的信息。

Add-XAServerMapping

(仅在迁移 XenApp 5 场时有效)添加源场中服务器与新场中工作组之间的映射。必须指定以下选项:
选项 说明
-ServerName server-name 源场中服务器的 MFCOM 名称。
-WorkerGroupName name 新场中工作组的名称。如果工作组不存在,会创建一个工作组。
例如,以下 cmdlet 会将名为 OfficeApps5 的服务器映射到名为 DenverAcctg 的工作组。
Add-XAServerMapping -ServerName OfficeApps5 -WorkerGroupName DenverAcctg

Add-XASettingOverride

指定对象属性(设置)的值。无论源场中该对象属性的值为何,对于新场中的该对象属性都将使用该值(该值将替代源场中的设置)。要显示可以使用 Add-XASettingOverride cmdlet 指定的对象属性的名称,请使用 Get-XALegacySettingName cmdlet。

可以指定以下选项:
选项 说明

-PropertyName property-name

属性名称。可以使用通配符。

-ObjectType object-type

对象类型。

有效值为:Administrator、Application、FarmConfiguration、Folder、LoadEvaluator、Policy 以及 ServerConfiguration。可以使用通配符。

-Value

新属性值。

-MatchValue

用新值替代该设置之前要匹配的原始属性值。如果该值不匹配,会跳过替代。

如果忽略此选项,会始终进行替代。

-ObjectName object-name

对象名称。

例如,以下 cmdlet 可将新场中已迁移应用程序的 CPU 优先级指定为“高”。
Add–XASettingOverride CpuPriorityLevel High
如果 CommandLineExecutable 属性的当前值为 C:\ProrgramFiles (x86)\Test\Test.exe,以下 cmdlet 可将其属性值更改为 C:\Program Files\Test\Test.exe。
Add-XASettingOverride -PropertyName CommandLineExecutable -ObjectType Application -Value "C:\Program Files\Test\Test.exe" -MatchValue "C:\Program Files (x86)\Test\Test.exe"

Get-XALegacySettingName

列出可与 Add-XASettingOverride cmdlet 结合使用的设置。可以指定以下选项:
选项 说明

-PropertyName property-name

属性名称。可以使用通配符。

-ObjectType object-type

对象类型。

有效值为:Administrator、Application、FarmConfiguration、Folder、LoadEvaluator、Policy 以及 ServerConfiguration。可以使用通配符。

例如,使用以下 cmdlet 可获取属性名称中包含“LicenseServer”的有效设置列表。
Get-XALegacySettingName *LicenseServer*
使用以下 cmdlet 可获取以“Server”开头且属性名称中包含“LicenseServer”的对象类型的有效设置列表。
Get-XALegacySettingName *LicenseServer* -ObjectType Server*

Get-XAMigrationObjectCount

显示源场和新场中的对象数。使用 -ImportOnly 选项可以生成与现有快照之间的差别。

Get-XAMigrationOption

列出迁移选项(即之前通过 Set-XAMigrationOption cmdlet 指定的迁移选项)。

Get-XAServerMapping

(仅在迁移 XenApp 5 场时有效)列出服务器到工作组的映射(即之前通过 Add-XAServerMapping cmdlet 指定的映射)。

Get-XASettingOverride

列出设置替代项(即之前通过 Add–XASettingOverride cmdlet 指定的属性值)。

Remove-XAServerMapping

(仅在迁移 XenApp 5 场时有效)删除服务器到工作组的映射(即之前通过 Add-XAServerMapping cmdlet 指定的映射)。

Remove-XASettingOverride

删除设置替代(即之前使用 Add-XASettingOverride cmdlet 指定的对象属性值)。

Set-XAMigrationOption

设置迁移选项。
选项 说明

-RemoteServerName name

要从中导出对象的源场中服务器的名称。如果未在 Start-XAMigration cmdlet 中指定 -RemoteServerName 选项,或者在使用图形化界面时未指定源场中的服务器,则将使用此值。

如果未在 Start-XAMigrationSet-XAMigrationOption cmdlet 中指定 -RemoteServerName 选项,或者未使用图形化界面指定源场中的服务器名称,迁移将会结束。

如果更改源服务器,请务必更新之前配置的任何自定义迁移选项以及引用源场中的对象或位置的工作组映射(如果需要)。

-DataFolderPath path

用于放置从源场中导出的数据的文件夹路径。如果该文件夹不存在,迁移中心将尝试创建该文件夹。

如果未指定此选项,导出的数据将移动到位于迁移中心安装文件下的 Data 文件夹。

-ObjectType object-type

对象类型。此选项与 –Include 和 –Exclude 选项一起使用,可指定对象名称。

有效值为:Administrator、Application、FarmConfiguration、Folder、LoadEvaluator、Policy 以及 ServerConfiguration。

如果您将文件夹对象从迁移中排除,则将迁移包含应用程序的应用程序文件夹,以便保留结构并防止重复。但是,不迁移不包含应用程序的服务器文件夹和应用程序文件夹。

-Include object-name

迁移中要包含的对象名称。此选项与 –ObjectType 选项一起使用。请使用逗号分隔多个对象名称。可以使用通配符。

-Exclude object-name

要从迁移中排除的对象名称。此选项与 –ObjectType 选项一起使用。请使用逗号分隔多个对象名称。可以使用通配符。

-Enabled $false | $true

提供了使用 -Exclude * 选项从迁移中排除使用 -ObjectType 选项指定的所有对象的备选方法。

-X86ApplicationList application

要迁移的 32 位应用程序。此应用程序的路径将从 \Program Files\ 转换为 \Program Files (x86)\。以逗号分隔多个应用程序名称。可以使用通配符。

例如,以下 cmdlet 使用 -ObjectType 和 -Exclude 选项从迁移中排除名为“A1”和“A2”的应用程序。
Set-XAMigrationOption –ObjectType Application –Exclude A1, A2
以下 cmdlet 使用 -ObjectType、-Include 以及 -Exclude 选项包括名称中包含“Microsoft”但不包含“Office”的所有应用程序。
Set-XAMigrationOption –ObjectType Application –Include *Microsoft* –Exclude *Office*
以下 cmdlet 使用 -ObjectType 和 -Enabled 选项禁止迁移所有应用程序。
Set-XAMigrationOption –ObjectType Application –Enabled $false
以下 cmdlet 使用 -X86ApplicationList 选项迁移 32 位应用程序 app1 和 app2,以及名称中包含“office”的所有 32 位应用程序,这些应用程序的路径将转换为 \Program Files (x86)\。
Set-XAMigrationOption -X86ApplicationList app1, app2, *office*

Start-XAMigration

启动迁移或迁移预览。可以指定以下选项:
选项 说明

-RemoteServerName name

要从中导出对象的源场中服务器的名称。

如果未指定此选项,但在 Set-XAMigrationOption cmdlet 中指定了 -RemoteServerName 选项,或者在使用图形化界面时指定了源场中的服务器,则将使用该名称。

如果未在 Start-XAMigrationSet-XAMigrationOption cmdlet 中指定 -RemoteServerName 选项,或者未使用图形化界面指定源场中的服务器名称,迁移将会结束。

如果更改源服务器,请务必更新之前配置的任何自定义迁移选项以及引用源场中的对象或位置的工作组映射(如果需要)。

-PendingReportOnly

生成用于指示要迁移的对象以及要更改的值的记录,但实际上并不执行迁移。使用此选项可进行迁移预览。

与标准 PowerShell -WhatIf 选项相比,此选项显示的信息更加详细。

-ExportOnly

将对象从源场导出到文件中,但并不将其导入新场中。

此选项通常仅在间接迁移期间使用;请参阅间接迁移与高级 cmdlet

-ImportOnly

将对象导入到新场。

此选项通常仅在间接迁移期间使用;请参阅间接迁移与高级 cmdlet