Citrix DaaS™

查看 PDF

用于迁移的自动化配置工具 cmdlet

May 4, 2026

投稿者:

C C

本页列出了该工具支持的所有用于迁移用例的 cmdlet 和参数。

所有 cmdlet 都接受以下类型之一的参数。
String（字符串）
List of strings（字符串列表）
Boolean（布尔值）：$true 或 $false
SwitchParameter（开关参数）：参数存在表示 $true；参数不存在表示 $false

注意：

SwitchParameter 是用于 true 或 false 选择的首选方法，但由于历史遗留问题，工具中仍使用布尔值。

下表是所有 cmdlet 的摘要。请参阅每个单独的部分以查找每个 cmdlet 支持的参数。

类别	Cmdlet	描述
本地到云迁移	`Export-CvadAcToFile`	将本地文件导出到 YAML 文件。
	`Import-CvadAcToSite`	将 YAML 文件导入云。支持创建、更新和删除操作。
	`Merge-CvadAcToSite`	将 YAML 文件导入云。支持创建和更新操作。
	`New-CvadAcToSite`	将 YAML 文件导入云。支持创建和更新操作。
	`Sync-CvadAcToSite`	一步完成导出和导入。
	精细迁移对于组件，请使用上述命令的参数。示例：`MachineCatalogs`、`Tags`。对于组件名称，请使用上述命令的参数。示例：`IncludeByName`、`ExcludeByName`。	选择性地仅迁移组件或组件名称
云到云 cmdlet	`Backup-CvadAcToFile`	备份云站点中的所有配置。
	`Restore-CvadAcToSite`	将备份的 YAML 文件还原到云站点。此云站点可以与源云站点相同或不同。
	`Remove-CvadAcFromSite`	从云中删除组件成员。
	精细迁移对于组件，请使用上述命令的参数。示例：`MachineCatalogs`、`Tags`。对于组件名称，请使用上述命令的参数。示例：`IncludeByName`、`ExcludeByName`。	选择性地仅迁移组件或组件名称
其他基本 cmdlet	`Compare-CvadAcToSite`	将本地 .yml 文件与云配置进行比较。
先决条件相关 cmdlet	`New-CvadAcCustomerInfoFile`	创建客户信息文件。
先决条件相关 cmdlet	`Set-CvadAcCustomerInfoFile`	更新现有客户信息文件。
支持和故障排除 cmdlet	`New-CvadAcZipInfoForSupport`	将所有日志和 .yml 文件压缩到一个 zip 文件中，以发送给 Citrix® 以获得支持。
	`Get-CvadAcStatus`	用于测试连接性并确保满足所有先决条件。返回有关工具的信息，例如版本号以及与云和连接器的连接状态。
	`Test-CvadAcConnectionWithSite`	测试与云站点的连接。
	`Find-CvadAcConnector`	查找现有连接器并确定其运行状态。
	`Get-CvadAcCustomerSites`	返回所有客户站点的列表。
	`New-CvadAcTemplateToFile`	为选定组件创建模板文件。
	`Show-CvadAcDocument`	在默认浏览器中显示此文档。
	`Find-CvadAcInFile`	文件内查找在组件 YAML 文件中搜索与一个或多个可能包含通配符的名称匹配的成员。
站点激活 cmdlet	`Set-CvadAcSiteActiveStateOnPrem`	将本地站点状态设置为活动或非活动。
站点激活 cmdlet	`Set-CvadAcSiteActiveStateCloud`	将云站点状态设置为活动或非活动。

-  |\[合并多个本地站点 cmdlet]\(#merging-multiple-on-premises-sites-cmdlets)|`New-CvadAcSiteMergingInfo`|创建站点合并前缀/后缀信息集。|

^^	`Set-CvadAcSiteMergingInfo`	更新现有站点合并前缀/后缀信息集。
^^	`Remove-CvadAcSiteMergingInfo`	删除现有站点合并前缀/后缀信息集。

有关参数及其使用方法的更多信息，请参阅精细迁移参数。

基本 cmdlet

本地到云 cmdlet

Export-CvadAcToFile - 将本地文件导出到 YAML 文件。

从本地设置导出配置。这是自动化配置的默认导出操作。不会对本地站点配置进行任何修改。导出的文件放置在 %HOMEPATH%\Documents\Citrix\AutoConfig 目录中一个唯一命名的 Export 子文件夹中。%HOMEPATH%\Documents\Citrix\AutoConfig 文件夹始终包含最新的导出本地站点配置。

-  参数：

名称描述必需？类型

| — | — | — | — |

Migrate by components（按组件迁移）

请参阅按组件迁移。

SwitchParameters（开关参数）

Filtering by object names（按对象名称筛选）	请参阅按对象名称筛选。	List of strings（字符串列表）
`TargetFolder`	指定导出目标文件夹。	String（字符串）
`Locale`	指定可导出的人类可读文本的语言。	String（字符串）
`Quiet`	禁止向控制台记录日志。	SwitchParameter（开关参数）
`AdminAddress`	当导出未在 Delivery Controller 上运行时，指定 Delivery Controller 的 DNS 或 IP 地址。	String（字符串）

CheckUserAndMachines 验证用户和计算机是否在 Active Directory 中。不在 Active Directory 中的用户和计算机可能导致导入失败。 $true 或 $false

ZipResults 将备份的 YAML 文件压缩到一个 zip 文件中。该文件与备份的 YAML 文件位于同一文件夹中，并具有与该文件夹相同的名称。 SwitchParameter（开关参数）

-  请参阅[Cmdlet 返回值](#cmdlet-return-values)

有三种将数据导入云的方法。运行特定的 cmdlet 可能会导致云站点上出现以下三种操作组合之一：

添加、更新和删除
- 仅添加和更新
仅添加

Cmdlet	添加	更新	删除
Import	X	X	X
Merge	X	X

-  | New | X | | |

Import-CvadAcToSite - 将 YAML 文件导入云。支持创建、更新和删除操作。

将所有本地文件导入云。此命令可确保云最终状态与本地状态相同。此选项会删除云中存在的任何更改。导入的站点配置文件源自 %HOMEPATH%\Documents\Citrix\AutoConfig。请谨慎使用。

参数：

名称	描述	类型
Migrate by components（按组件迁移）	请参阅按组件迁移。	SwitchParameters（开关参数）
Filtering by object names（按对象名称筛选）	请参阅按对象名称筛选。	List of strings（字符串列表）
Cloud-accessing parameters（云访问参数）	请参阅云访问参数。	SwitchParameters（开关参数）
`SourceFolder`	标识 %HOMEPATH%\Documents\Citrix\AutoConfig 的替代根文件夹。	String（字符串）
`Locale`	指定可导出的人类可读文本的语言。	String（字符串）
`Quiet`	禁止向控制台记录日志。	SwitchParameter（开关参数）
`DisplayLog`	在 cmdlet 完成时显示日志文件。设置为 `$false` 以禁止显示日志。	`$true` 或 `$false`
`Merge`	设置为 `$true` 时，仅将组件添加到云站点。不删除组件。设置为 `$false` 以删除组件。	`$true` 或 `$false`

-  | `AddOnly` | 设置为 `$true` 时，仅添加新组件，不更新或删除现有组件。设置为 `$false` 以允许更新和删除。当此参数为 `$true` 时，`Merge` 将被忽略。 | | `$true` 或 `$false` |

MergePolicies 合并策略设置和筛选器。仅当要导入的策略已存在于云 DDC 中时，才会发生合并。合并策略的结果是，云 DDC 策略将包含其已有的设置和筛选器，以及任何正在导入的新设置和筛选器。请注意，当设置和筛选器发生冲突时，导入的值优先。

OnErrorAction 请参阅 OnErrorAction 参数。

-  请参阅[Cmdlet 返回值](#cmdlet-return-values)

Merge-CvadAcToSite - 将 YAML 文件导入到云中。支持创建和更新操作。

将本地文件合并到云中，但不删除云中或本地站点中的任何组件。这会保留已在云中进行的更改。如果 Citrix Cloud 中存在同名组件，此命令可以修改该组件。这是自动配置的默认导入操作。合并的站点配置文件源自 %HOMEPATH%\Documents\Citrix\AutoConfig。

参数：

名称描述必需？类型
- |—|—|—|—|

按组件迁移	请参阅按组件迁移。
按对象名称筛选	请参阅按对象名称筛选。
云访问参数	请参阅云访问参数。
`SourceFolder`	标识 %HOMEPATH%\Documents\Citrix\AutoConfig 的替代根文件夹。
`Locale`	指定可导出的人类可读文本的语言。
`Quiet`	禁止向控制台记录日志。
`DisplayLog`	在 cmdlet 完成时显示日志文件。设置为 `$false` 可禁止显示日志。
`Merge`	设置为 `$true` 时，仅将组件添加到云站点。不删除组件。设置为 `$false` 可删除组件。
`AddOnly`	设置为 `$true` 时，仅添加新组件，不更新或删除现有组件。设置为 `$false` 可允许更新和删除。当此参数为 `$true` 时，`Merge` 将被忽略。
`MergePolicies`	合并策略设置和筛选器。仅当要导入的策略已存在于云 DDC 中时才进行合并。合并策略的结果是，云 DDC 策略除了包含导入的任何新设置和筛选器外，还包含其已有的设置和筛选器。请注意，当设置和筛选器发生冲突时，导入的值优先。
`OnErrorAction`	请参阅OnErrorAction 参数。

返回值：

请参阅Cmdlet 返回值

New-CvadAcToSite - 将 YAML 文件导入到云中。支持创建和更新操作。

将本地站点配置导入到云中，但仅添加新组件。现有云站点组件既不更新也不删除。如果现有云站点组件必须保持不变，请使用此命令。

参数：

名称	描述	类型
按组件迁移	请参阅按组件迁移。	SwitchParameters
按对象名称筛选	请参阅按对象名称筛选。	List of strings
云访问参数	请参阅云访问参数。	SwitchParameters
`SourceFolder`	标识 %HOMEPATH%\Documents\Citrix\AutoConfig 的替代根文件夹。	String
`Locale`	指定可导出的人类可读文本的语言。	String
`Quiet`	禁止向控制台记录日志。	SwitchParameter
`DisplayLog`	在 cmdlet 完成时显示日志文件。设置为 `$false` 可禁止显示日志。	`$true` 或 `$false`
`OnErrorAction`	请参阅OnErrorAction 参数。	String

返回值：
- 请参阅Cmdlet 返回值

Sync-CvadAcToSite - 一步完成导出和导入。

Sync 在一个步骤中执行导出和导入。使用 SourceTargetFolder 参数指定导出/导入目标文件夹。

参数：

名称	描述	类型
按组件迁移	请参阅按组件迁移	SwitchParameters
按对象名称筛选	请参阅按对象名称筛选	List of strings
云访问参数	请参阅云访问参数	SwitchParameters
`SourceTargetFolder`	指定导出/导入目标文件夹。	String
`Locale`	指定可导出的人类可读文本的语言。	String

AdminAddress 当导出未在交付控制器上执行时，指定交付控制器的 DNS 或 IP 地址。

`Quiet`	禁止向控制台记录日志。
`DisplayLog`	在 cmdlet 完成时显示日志文件。设置为 `$false` 可禁止显示日志。
`Merge`	设置为 `$true` 时，仅将组件添加到云站点。不删除组件。设置为 `$false` 可删除组件。
`AddOnly`	设置为 `$true` 时，仅添加新组件，不更新或删除现有组件。设置为 `$false` 可允许更新和删除。当此参数为 `$true` 时，`Merge` 将被忽略。
`MergePolicies`	合并策略设置和筛选器。仅当要导入的策略已存在于云 DDC 中时才进行合并。合并策略的结果是，云 DDC 策略除了包含导入的任何新设置和筛选器外，还包含其已有的设置和筛选器。请注意，当设置和筛选器发生冲突时，导入的值优先。

返回值：

请参阅Cmdlet 返回值

云到云 cmdlet

Backup-CvadAcToFile - 备份云站点中的所有配置。

将您的云配置导出到 .yml 文件。此备份可用于备份和还原过程，以还原丢失的组件。

参数：

名称	描述	类型
按组件迁移	请参阅按组件迁移	SwitchParameters
云访问参数	请参阅云访问参数	SwitchParameters
`TargetFolder`	指定导出目标文件夹。	String
`Locale`	指定可导出的人类可读文本的语言。	String
`Quiet`	禁止向控制台记录日志。	SwitchParameter
`DisplayLog`	在 cmdlet 完成时显示日志文件。设置为 `$false` 可禁止显示日志。	`$true` 或 `$false`
`ZipResults`	将备份的 YAML 文件压缩为单个 zip 文件。该文件与备份的 YAML 文件位于同一文件夹中，并具有与该文件夹相同的名称。	SwitchParameter

返回值：
请参阅Cmdlet 返回值

Restore-CvadAcToSite - 将备份 YAML 文件还原到云站点。此云站点可以与源云站点相同或不同。
将云站点还原到以前的配置。导入的文件源自使用 -RestoreFolder 参数指定的文件夹，该参数标识包含要还原到云站点的 .yml 文件的文件夹。这必须是完全限定的文件夹规范。此 cmdlet 可用于恢复到以前的配置，或用于备份和还原云站点。此命令可以添加、删除和更新云站点。
参数：
名称描述必需？类型
|—|—|—|—|
按组件迁移请参阅按组件迁移。
按对象名称筛选请参阅按对象名称筛选。
云访问参数请参阅云访问参数。
RestoreFolder 标识包含要还原到云站点的 .yml 文件的文件夹。这必须是完全限定的文件夹规范。

`Locale`	指定可导出的人类可读文本的语言。
`Quiet`	禁止向控制台记录日志。
`DisplayLog`	在 cmdlet 完成时显示日志文件。设置为 `$false` 可禁止显示日志。
`Merge`	设置为 `$true` 时，仅将组件添加到云站点。不删除组件。设置为 `$false` 可删除组件。
`AddOnly`	设置为 `$true` 时，仅添加新组件，不更新或删除现有组件。设置为 `$false` 可允许更新和删除。当此参数为 `$true` 时，`Merge` 将被忽略。

MergePolicies 合并策略设置和筛选器。仅当要导入的策略已存在于云 DDC 中时，才会发生合并。合并策略的结果是，云 DDC 策略包含其已有的设置和筛选器，以及任何新导入的设置和筛选器。请注意，当设置和筛选器发生冲突时，导入的值优先。

OnErrorAction 请参阅OnErrorAction 参数。

返回值：
- 请参阅Cmdlet 返回值
Remove-CvadAcFromSite – 从云中删除组件成员。

可以重置整个站点，或从组件中删除成员项（例如，从目录列表中删除一个计算机目录）。当与 IncludeByName 参数结合使用时，这可用于选择性地删除特定成员。

参数：

名称	描述	必需？	类型
按组件迁移	请参阅按组件迁移		SwitchParameters
按对象名称筛选	请参阅按对象名称筛选		List of strings

云访问参数请参阅云访问参数

`Quiet`	禁止向控制台记录日志。
`DisplayLog`	在 cmdlet 完成时显示日志文件。设置为 `$false` 可禁止显示日志。

返回值：

请参阅Cmdlet 返回值

其他基本 cmdlet

Compare-CvadAcToSite - 将本地 .yml 文件与云配置进行比较，生成由 Import、Merge 或 Restore cmdlet 所做的更改报告。

参数：

名称	描述	类型
按组件迁移	请参阅按组件迁移。	SwitchParameters
按对象名称筛选	请参阅按对象名称筛选。	List of strings
云访问参数	请参阅云访问参数。	SwitchParameters
`SourceFolder`	标识 %HOMEPATH%\Documents\Citrix\AutoConfig 的替代根文件夹。	String
`Locale`	指定可导出的人类可读文本的语言。	String
`Quiet`	禁止向控制台记录日志。	SwitchParameter
`DisplayLog`	在 cmdlet 完成时显示日志文件。设置为 `$false` 可禁止显示日志。	`$true` 或 `$false`
`Merge`	设置为 `$true` 时，仅将组件添加到云站点。不删除组件。设置为 `$false` 可删除组件。	`$true` 或 `$false`
`AddOnly`	设置为 `$true` 时，仅添加新组件，不更新或删除现有组件。设置为 `$false` 可允许更新和删除。当此参数为 `$true` 时，`Merge` 将被忽略。	`$true` 或 `$false`
`OnErrorAction`	请参阅OnErrorAction 参数。	String

返回值：
- 请参阅Cmdlet 返回值

粒度迁移参数

按组件迁移

以下组件可与支持它们的 cmdlet 一起指定。未指定组件参数时，会自动选择 All 选项。为避免错误，我们建议您按以下顺序迁移组件：

All
- Tags
AdminRoles
- AdminScopes
HostConnections
- MachineCatalogs
StoreFronts
- DeliveryGroups
- ApplicationGroups
ApplicationFolders
- Applications
GroupPolicies
- UserZonePreference

按对象名称筛选

按组件名称迁移

IncludeByName 和 ExcludeByName 参数允许按名称在 cmdlet 中包含和排除组件成员。在任何受支持的 cmdlet 中，一次只能选择一个组件（例如，交付组）。如果组件成员同时存在于这两个区域中，则排除会覆盖任何其他参数，并且会在日志修复列表中创建一个条目，用于标识已排除的组件和成员名称。

IncludeByName 和 ExcludeByName 接受组件成员名称列表。任何名称都可以包含一个或多个通配符。支持两种类型的通配符。当任何成员名称包含特殊字符时，组件成员名称列表必须用单引号括起来。

-  `*` 匹配任意数量的字符

? 匹配单个字符

IncludeByName 和 ExcludeByName 还可以接受一个文件，其中包含一个成员列表，每个成员可以是显式的或包含通配符。文件中的每一行可以包含一个成员。成员名称中的前导和尾随空格将被去除。文件名必须以 @ 符号开头并用单引号括起来（这是 PowerShell 的要求，以防止 @ 被重新解释）。除了与成员名称混合使用外，还可以列出多个文件。

合并所有名称以 DgSite1 开头并包含 Home2 的交付组的示例如下所示：

[[CODE_BLOCK_0]]

按交付组名称

ByDeliveryGroupName 按应用程序和应用程序组的交付组名称进行筛选。此参数始终是一个包含列表，用于根据其交付组关联来标识要包含的成员。

ByDeliveryGroupName 接受交付组名称列表。任何名称都可以包含一个或多个通配符。支持两种类型的通配符。

* 匹配任意数量的字符
- ? 匹配单个字符
以下示例合并了引用所有以 EastDg 开头的交付组名称的所有应用程序。

[[CODE_BLOCK_1]]

排除已禁用

ExcludeDisabled 从导入操作中筛选出所有已禁用的应用程序和应用程序组。ExcludeDisabled 默认为 false，这意味着无论其启用状态如何，所有应用程序和应用程序组都将被导入。

按计算机名称

-  `ByMachineName` 按计算机目录和交付组的计算机名称进行筛选。此参数始终是一个包含列表，用于根据其计算机名称关联来标识要包含的成员。

-  `ByMachineName` 接受计算机名称列表，其中任何名称都可以包含一个或多个通配符。支持两种类型的通配符。

* 匹配任意数量的字符
- ? 匹配单个字符

当导出或导入并使用 ByMachineName 且计算机名称筛选器导致计算机目录或交付组中没有计算机时，该计算机目录或交付组将从导出或导入中排除。

注意： > > 在任何导入类型 cmdlet 中使用 ByMachineName 会导致 MergeMachines 设置为 $true。

合并计算机

-  `MergeMachines` 设置为 `$true` 时，指示导入操作仅将计算机添加到计算机目录或交付组。计算机不会被删除，从而允许增量添加操作。

MergeMachines 默认为 false，这意味着如果计算机不在机器目录或交付组 .yml 文件中，则会将其删除。当使用 ByMachineName 时，MergeMachines 设置为 $true，但可以通过将 MergeMachines 设置为 false 来覆盖此值。

与先决条件相关的 cmdlet

New-CvadAcCustomerInfoFile - 创建客户信息文件。默认情况下，客户信息文件位于 %HOMEPATH%\Documents\Citrix\AutoConfig。

参数：

名称	描述	必需？	类型
`CustomerId`	客户的 ID。	x	字符串

`ClientId`	在 Citrix Cloud 上创建的客户客户端 ID。使用此参数时，必须指定 CustomerId 和 Secret。	有条件地	字符串
`Secret`	在 Citrix Cloud 上创建的客户密钥。使用此参数时，必须指定 CustomerId 和 ClientId。	有条件地	字符串
`Environment`	生产、ProductionGov 或 ProductionJP 环境。		枚举

`LogFileName`	将日志文件前缀从 CitrixLog 更改为其他名称。
`AltRootUrl`	仅在 Citrix 的指导下使用。
`StopOnError`	在首次发生错误时停止操作。
`TargetFolder`	使用指定的文件夹作为根文件夹，而不是 %HOMEPATH%\Documents\Citrix\AutoConfig。
`Locale`	使用指定的区域设置，而不是从运行该工具的系统派生的区域设置。
`Editor`	使用指定的编辑器在每个 cmdlet 完成时显示日志。Notepad.exe 是默认编辑器。此参数必须包含编辑器的完全限定文件规范，并且编辑器必须将其作为唯一参数来获取日志文件规范。
`SecurityCsvFileSpec`	指向从 Citrix Identity and Access Management 下载的 SecurityClient.csv 文件的完全限定文件规范。使用此参数时，必须指定 CustomerId。

请参阅 Cmdlet 返回值

Set-CvadAcCustomerInfoFile - 更新现有客户信息文件。仅更改 cmdlet 指定的参数。CustomerInfo.yml 文件中所有未指定的参数值保持不变。

参数：

名称	描述	类型
`CustomerId`	客户的 ID。	字符串
`ClientId`	在 Citrix Cloud 上创建的客户客户端 ID。	字符串
`Secret`	在 Citrix Cloud 上创建的客户密钥。	字符串
`Environment`	生产、ProductionGov 或 ProductionJP 环境。	枚举
`LogFileName`	将日志文件前缀从 CitrixLog 更改为其他名称。	字符串

`StopOnError`	在首次发生错误时停止操作。
`TargetFolder`	使用指定的文件夹作为根文件夹，而不是 %HOMEPATH%\Documents\Citrix\AutoConfig。
`Locale`	使用指定的区域设置，而不是从运行该工具的系统派生的区域设置。

`Editor`	使用指定的编辑器在每个 cmdlet 完成时显示日志。Notepad.exe 是默认编辑器。此参数必须包含编辑器的完全限定文件规范，并且编辑器必须将其作为唯一参数来获取日志文件规范。
`SecurityCsvFileSpec`	指向从 Citrix Identity and Access Management 下载的 SecurityClient.csv 文件的完全限定文件规范。使用此参数时，必须指定 CustomerId。

请参阅 Cmdlet 返回值

与先决条件相关的参数

除了云访问参数之外，以下参数可与先决条件相关的 cmdlet 一起使用：
Environment – 生产或 ProductionGov 环境。
LogFileName – 将日志文件前缀从 CitrixLog 更改为其他名称。
StopOnError – 在首次发生错误时停止操作。
AlternateRootFolder – 使用指定的文件夹作为根文件夹，而不是 %HOMEPATH%\Documents\Citrix\AutoConfig。
Locale – 使用指定的区域设置，而不是从运行该工具的系统派生的区域设置。
Editor – 使用指定的编辑器在每个 cmdlet 完成时显示日志。Notepad.exe 是默认编辑器。此参数必须包含编辑器的完全限定文件规范，并且编辑器必须将其作为唯一参数来获取日志文件规范。
支持和故障排除 cmdlet
New-CvadAcZipInfoForSupport - 将所有日志和 .yml 文件压缩到一个 zip 文件中，以发送给 Citrix 以获得支持。客户敏感信息（CustomerInfo.yml 和 CvadAcSecurity.yml）不包含在 zip 文件中。Icon.yml 文件也因其大小而被排除。zip 文件放置在 %HOMEPATH%\Documents\Citrix\AutoConfig 中，并根据日期和时间戳命名为 CvadAcSupport_yyyy_mm_dd_hh_mm_ss.zip。此 zip 文件也可以用作备份。
- 参数：
名称描述必需？类型
|—|—|—|—|
TargetFolder 指定用于创建和保存 zip 文件的目标文件夹。
Quiet 禁止向控制台记录日志。
返回：
- 带有 zip 文件名和位置的 zip 文件显示在命令提示符下。
Get-CvadAcStatus - 用于测试连接性并确保满足所有先决条件。返回有关工具的信息，例如版本号以及与云和连接器的连接状态。
参数：
名称描述必需？类型
|—|—|—|—|
Cloud-accessing parameters 请参阅云访问参数
SiteId 标识要连接到的站点。

AdminAddress 这是用于验证管理员访问级别的本地 Delivery Controller 的 DNS 或 IP 地址。如果该工具未在 Delivery Controller 上运行，则需要此参数。

返回值：
显示每个项目的运行结果。
Test-CvadAcConnectionWithSite – 测试与云站点的连接，以验证通信连接是否正常工作。此 cmdlet 使用云访问参数或 CustomerInfo.yml 文件来指定客户连接信息。
参数：

名称	描述	必需？	类型
云访问参数	请参阅云访问参数		SwitchParameters
`Quiet`	禁止向控制台记录日志。		SwitchParameter

返回值：

测试结果显示在命令行中。

Find-CvadAcConnector - 查找现有连接器并确定其运行状态。此 cmdlet 使用 CustomerInfo.yml 文件中的信息或客户 ID 参数来查找客户的连接器。

参数：
名称描述必需？类型
|–|–|–|–|

CustomerInfoFileSpec 指向客户信息文件的文件规范，用于覆盖默认位置和名称。当提供 CustomerId 参数时，此参数将被忽略。

CustomerId 客户 ID。此参数将覆盖 CustomerInfo.yml 文件中的相同值。
返回值：
- 结果显示在命令行中。
Get-CvadAcCustomerSites - 返回所有客户站点的列表。此 cmdlet 使用云访问参数或 CustomerInfo.yml 文件来指定客户连接信息。

参数：
- 请参阅云访问参数
返回值：
- 显示找到的客户站点 ID 列表。

New-CvadAcTemplateToFile – 为选定组件创建模板文件，允许您手动创建导入文件。

参数：

名称	描述	必需？	类型
按组件迁移	请参阅按组件迁移		SwitchParameters
`TargetFolder`	指定导出目标文件夹。		String

返回值：

请参阅Cmdlet 返回值

Show-CvadAcDocument - 在默认浏览器中显示此文档。

参数：
- 无。
返回：
- 在默认网页浏览器中显示此网页。

Find-CvadAcInFile - 文件内查找功能会搜索组件 YAML 文件，以查找与一个或多个可能包含通配符的名称匹配的成员。结果是找到的成员的报告。文件内查找功能一次只能搜索一个组件。文件内查找功能会搜索当前文件夹和所有子文件夹中的所有 YAML 文件。使用 FindSourceFolder 限制要搜索的文件数量。

参数：

名称	描述	类型
按组件迁移	请参阅按组件迁移。注意：`-All` 值无效。	SwitchParameters
`IncludeByName`	一个列表，指定在将站点活动状态设置为活动时要包括的交付组名称。名称中支持“*”和“?”通配符。	字符串列表
`Unique`	仅报告唯一找到的成员。	SwitchParameter
`IncludeYaml`	包括成员特定的 YAML。	SwitchParameter
`FindSourceFolder`	文件查找开始搜索的文件夹。	字符串
`DisplayLog`	在 cmdlet 完成时显示日志文件。设置为 `$false` 可禁止显示日志。	SwitchParameter
`Quiet`	禁止向控制台记录日志。	SwitchParameter

创建包含指定组件的找到成员的报告。

站点激活 cmdlet

有关激活站点和这些 cmdlet 用法的更多信息，请参阅激活站点。

Set-CvadAcSiteActiveStateOnPrem - 将本地站点状态设置为活动或非活动。

参数：

名称	描述	类型
云访问参数	请参阅云访问参数	SwitchParameters
`SiteActive`	如果存在，则将本地站点设置为活动，从而从所有交付组中移除维护模式。如果此参数不存在，则所有交付组都将设置为维护模式。	SwitchParameter
`IncludeByName`	一个列表，指定在将站点活动状态设置为活动时要包括的交付组名称。名称中支持“*”和“?”通配符。	字符串列表
`ExcludeByName`	一个列表，指定在将站点活动状态设置为活动时要排除的交付组名称。名称中支持“*”和“?”通配符。	字符串列表
`Quiet`	禁止向控制台记录日志。	SwitchParameter
`DisplayLog`	在 cmdlet 完成时显示日志文件。设置为 `$false` 可禁止显示日志。	`$true or $false`

请参阅Cmdlet 返回值

Set-CvadAcSiteActiveStateCloud - 将云站点状态设置为活动或非活动。

参数：

名称	描述	类型
云访问参数	请参阅云访问参数	SwitchParameters
`SiteActive`	如果存在，则将云站点设置为活动，从而从所有交付组中移除维护模式。如果此参数不存在，则所有交付组都将设置为维护模式。	SwitchParameter
`IncludeByName`	一个列表，指定在将站点活动状态设置为活动时要包括的交付组名称。名称中支持“*”和“?”通配符。	字符串列表
`ExcludeByName`	一个列表，指定在将站点活动状态设置为活动时要排除的交付组名称。名称中支持“*”和“?”通配符。	字符串列表
`Quiet`	禁止向控制台记录日志。	SwitchParameter
`DisplayLog`	在 cmdlet 完成时显示日志文件。设置为 `$false` 可禁止显示日志。	`$true or $false`

请参阅Cmdlet 返回值

合并多个本地站点 cmdlet

有关站点合并和这些 cmdlet 用法的更多信息，请参阅将多个站点合并到单个站点。

New-CvadAcSiteMergingInfo - 创建站点合并前缀/后缀信息集。无需一开始就知道所有前缀或后缀。可以使用 Set-CvadAcSiteMergingInfo 或通过手动编辑 SiteMerging.yml 文件来更新它们。参数：

名称	描述	必需？	类型
`SiteName`	用于标识特定站点的前缀/后缀集的名称。它可以与实际站点的名称匹配，但不是必需的。	x	字符串
站点合并参数	请参阅站点合并参数		SwitchParameters
`Quiet`	禁止向控制台记录日志。		SwitchParameter

Set-CvadAcSiteMergingInfo - 更新现有站点合并前缀/后缀信息集。

参数：

名称	描述	必需？	类型
`SiteName`	用于标识特定站点的所有前缀/后缀集的名称。它可以与实际站点的名称匹配，但并非必须如此。	是	字符串
站点合并参数	请参阅站点合并参数		开关参数
`Quiet`	禁止向控制台记录日志。		开关参数

返回值：

Remove-CvadAcSiteMergingInfo - 删除现有站点合并前缀/后缀信息集。

参数：
- SiteName – 标识站点前缀和后缀集。这是一个字符串，是必需的。
返回值：
- 无

站点合并参数

运行站点合并 cmdlet 时可以使用以下参数。所有列出的参数均为字符串。

SiteName – 用于标识特定站点的所有前缀/后缀集的名称。它可以与实际站点的名称匹配，但并非必须如此。SiteName 是一个必需参数。
AdminScopedPrefix – 应用于管理员范围的前缀。
ApplicationPrefix - 应用于应用程序的前缀。
ApplicationFolderPrefix – 应用于应用程序文件夹的前缀；ApplicationFolderPrefix 可以与 ApplicationFolderRoot 结合使用。
ApplicationFolderRoot – 应用程序文件夹的新根文件夹。这会创建一个额外的文件夹层次结构。ApplicationFolderRoot 可以与 ApplicationFolderPrefix 结合使用。
ApplicationGroupPrefix – 应用程序组的前缀。
ApplicationUserPrefix – 应用于用户看到的应用程序名称的前缀。
ApplicationAdminPrefix – 应用于管理员看到的应用程序名称的前缀。
DeliveryGroupPrefix – 应用于交付组的前缀。
GroupPolicyPrefix – 应用于策略名称的前缀。
HostConnectionPrefix – 应用于主机连接的前缀。
MachineCatalogPrefix – 应用于计算机目录的前缀。
StoreFrontPrefix – 应用于 StoreFront™ 名称的前缀。
TagPrefix – 应用于标签的前缀。
AdminScopedSuffix – 应用于管理员范围的后缀。
ApplicationSuffix - 应用于应用程序的后缀。
ApplicationFolderSuffix – 应用于应用程序文件夹的后缀；ApplicationFolderSuffix 可以与 ApplicationFolderRoot 结合使用。
ApplicationGroupSuffix – 应用程序组的后缀。
ApplicationUserSuffix – 应用于用户看到的应用程序名称的后缀。
ApplicationAdminSuffix – 应用于管理员看到的应用程序名称的后缀。
DeliveryGroupSuffix – 应用于交付组的后缀。
GroupPolicySuffix – 应用于策略名称的后缀。
HostConnectionSuffix – 应用于主机连接的后缀。
MachineCatalogSuffix – 应用于计算机目录的后缀。
StoreFrontSuffix – 应用于 StoreFront 名称的后缀。
TagSuffix – 应用于标签的后缀。
SiteRootFolder – 用于导出和导入的完全限定文件夹名称；这可以是本地文件夹或文件共享。

通用参数

云访问参数

所有访问云的 cmdlet 都支持以下额外参数。

注意：

CustomerId、ClientId 和 Secret 可以放置在 CustomerInfo.yml 文件中，也可以使用以下参数通过 cmdlet 指定。当它们在两个位置都指定时，cmdlet 参数优先。

CustomerId – 在 Rest API 中使用的客户 ID，访问所有 Rest API 都需要此 ID。您的客户 ID 位于 Citrix Cloud 中。
ClientId – 在 Citrix Cloud 身份和访问管理网站上创建的客户端 ID。获取所有 Rest API 身份验证所需的持有者令牌需要此 ID。
Secret – 在 Citrix Cloud 身份和访问管理网站上创建的密钥。获取所有 Rest API 身份验证所需的持有者令牌需要此密钥。
CustomerInfoFileSpec – 指向客户信息文件的文件规范，用于覆盖默认位置和名称。

迁移模式参数

修改云站点配置的 cmdlet（Import、Restore、Merge、New 和 Sync）支持以下额外参数，以提供更大的灵活性。

CheckMode – 执行导入操作，但不进行任何更改。所有预期更改都会在导入完成前报告。您可以使用此命令在导入发生前对其进行测试。
BackupFirst – 在修改云配置之前，将云内容备份到 .yml 文件。此功能默认启用。
Confirm – 如果为 true，则提示用户确认他们要更改云站点配置。Remove cmdlet 会因其破坏性而显示提示。如果不需要提示（例如在自动化脚本中运行），请将其设置为 false。Confirm 默认为 true。
SecurityFileFolder – 这是包含 CustomerInfo.yml 文件的完全限定文件夹，该文件可能指向本地文件夹或可能受身份验证控制的网络共享文件夹。该工具不会提示输入凭据；在运行该工具之前，必须获得对受控资源的访问权限。
SiteName – 指定导入时要使用的站点合并前缀和后缀集。
SiteActive – 指定导入的站点是活动还是非活动状态。默认情况下，此参数设置为 $false，表示导入的站点处于非活动状态。

日志显示参数

Export、Import、Sync、Restore、Backup、Compare 和 Remove cmdlet 在操作完成后会显示日志文件。您可以通过将 -DisplayLog 参数设置为 $false 来禁止显示。默认情况下，使用 Notepad.exe 显示日志文件。您可以在 CustomerInfo.yml 文件中指定不同的编辑器。

Editor: C:\Program Files\Notepad++\notepad++.exe

Cmdlet 返回值

ActionResult

所有 cmdlet 都返回以下值。

            public class ActionResult
            {
                public bool                         Overall_Success;
                public Dictionary<string, string>   Individual_Success;
                public object                       CustomResult;
            }

Overall_Success 返回一个布尔值，指示 cmdlet 在所有选定组件上的整体成功状态： true 表示成功， false 表示不成功。

Individual_Success 为每个主要组件返回一个或三个值。组件结果可以是“成功”(Success)、“失败”(Failure) 或“已跳过”(Skipped)。“已跳过”(Skipped) 表示该组件未被 cmdlet 选定执行。

CustomResult 是特定于 cmdlet 的。

CustomResult

Import 、 Merge 、 Restore 、 Sync 、 Compare 、 Compare File 和 Remove 将以下自定义结果信息返回到 EvaluationResultData 的单个实例。

注意：

Export 和 Template cmdlet 不返回自定义结果。

                public class EvaluationResultData
                {
                    public Dictionary<string, Dictionary<string, ActionResultValues >> EvaluationResults;
                    public int                  Added;
                    public int                  Updated;
                    public int                  Deleted;
                    public int                  NoChange;
                    public int                  TotalChanged;
                    public EvaluationResults     OverallResult;
                    public string               CloudBackupFolder;
                    public string               SourceBackupFolder;
                }
                Where:
                public enum ActionResultValues
               {
                    Add,
                    Update,
                    Delete,
                    Identical,
                    DoNothing
                }
                public enum EvaluationResults
                {
                    Success,
                    Failure,
                    Skipped
                }

EvaluationResults 显示一个列表，其中每个选定组件包含一个条目。键是组件名称，值是每个组件成员及其在该组件成员上执行的操作列表。操作可以是 ActionResultValues 值中的任何一个。

Added 、 Updated 、 Deleted 和 NoChange 依序指示已添加、已更新、已删除的组件成员总数或未执行任何操作的组件成员总数。

TotalChanged 是 Added 、 Updated 和 Deleted 的总和。

OverallResult 是一个布尔值，指示 cmdlet 的结果。 True 表示所有组件均完全成功， false 表示处理一个或多个组件失败。

CloudBackupFolder 是 cmdlet 执行任何云修改操作之前云站点配置备份的完全限定文件规范。

SourceBackupFolder 是 cmdlet 完成后创建的源文件备份的完全限定文件规范。默认情况下，这些文件位于 %HOMEPATH%\Documents\Citrix\AutoConfig。

PowerShell 帮助

每个 cmdlet 都提供了 PowerShell 帮助。所有参数都随每个 cmdlet 一起记录，并附带对 cmdlet 的简要说明。要访问任何 cmdlet 的帮助，请在 cmdlet 前面键入 Get-Help 。

Get-Help Import-CvadAcToSite

本内容的正式版本为英文版。部分 Cloud Software Group 文档内容采用了机器翻译，仅供您参考。Cloud Software Group 无法控制机器翻译的内容，这些内容可能包含错误、不准确或不合适的语言。对于从英文原文翻译成任何其他语言的内容的准确性、可靠性、适用性或正确性，或者您的 Cloud Software Group 产品或服务沿用了任何机器翻译的内容，我们均不作任何明示或暗示的保证，并且适用的最终用户许可协议或服务条款或者与 Cloud Software Group 签订的任何其他协议（产品或服务与已进行机器翻译的任何文档保持一致）下的任何保证均不适用。对于因使用机器翻译的内容而引起的任何损害或问题，Cloud Software Group 不承担任何责任。

这是否有帮助？

用于迁移的自动化配置工具 cmdlet

May 4, 2026

投稿者:

C C

May 4, 2026

投稿者:

C C

这是否有帮助？

用于迁移的自动化配置工具 cmdlet

基本 cmdlet

本地到云 cmdlet

云到云 cmdlet

其他基本 cmdlet

粒度迁移参数

按组件迁移

按对象名称筛选

按组件名称迁移

按交付组名称

排除已禁用

按计算机名称

合并计算机

与先决条件相关的 cmdlet

与先决条件相关的参数

支持和故障排除 cmdlet

站点激活 cmdlet

合并多个本地站点 cmdlet

站点合并参数

通用参数

云访问参数

迁移模式参数

日志显示参数

Cmdlet 返回值

ActionResult

CustomResult

PowerShell 帮助

在本文中