自动化配置工具 cmdlet 命令用于迁移
此页面列出了该工具支持的所有用于迁移用例的 cmdlet 命令和参数。
所有 cmdlet 命令都接受以下类型之一的参数。
- 字符串
- 字符串列表
- 布尔值：
$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 |
创建客户信息文件。 |
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 |
将本地站点状态设置为活动或非活动。 |
Set-CvadAcSiteActiveStateCloud |
将云站点状态设置为活动或非活动。 | |
|
合并多个本地站点 cmdlet 命令
|
New-CvadAcSiteMergingInfo |
创建站点合并前缀/后缀信息集。 |
Set-CvadAcSiteMergingInfo |
更新现有站点合并前缀/后缀信息集。 | |
Remove-CvadAcSiteMergingInfo |
删除现有站点合并前缀/后缀信息集。 |
有关参数及其使用方法的更多信息，请参阅精细迁移参数。
基本 cmdlet 命令
本地到云 cmdlet 命令
-
Export-CvadAcToFile- 将本地文件导出到 YAML 文件。从本地设置导出配置。这是自动化配置的默认导出操作。不会对本地站点配置进行任何修改。导出的文件放置在 %HOMEPATH%\Documents\Citrix\AutoConfig 目录中一个唯一命名的 Export 子文件夹中。%HOMEPATH%\Documents\Citrix\AutoConfig 文件夹始终包含最新的导出本地站点配置。
参数：
名称 描述 必需？ 类型 按组件迁移 请参阅按组件迁移 SwitchParameters 按对象名称筛选 请参阅按对象名称筛选 字符串列表 TargetFolder指定导出目标文件夹。 字符串 Locale指定可导出的人类可读文本的语言。 字符串 Quiet禁止向控制台记录日志。 SwitchParameter AdminAddress当导出未在 Delivery Controller 上运行时，指定 Delivery Controller 的 DNS 或 IP 地址。 字符串 CheckUserAndMachines验证用户和计算机是否在 Active Directory 中。不在 Active Directory 中的用户和计算机可能导致导入失败。 $true或$falseZipResults将备份的 YAML 文件压缩到一个 zip 文件中。该文件与备份的 YAML 文件位于同一文件夹中，并具有与该文件夹相同的名称。 SwitchParameter 返回：
- 请参阅Cmdlet 命令返回值
有三种将数据导入云的方法。运行特定的 cmdlet 命令可以导致云站点上的三种操作组合之一：
- 添加、更新和删除
- 仅添加和更新
- 仅添加
| Cmdlet 命令 | 添加 | 更新 | 删除 |
|---|---|---|---|
| Import | X | X | X |
| Merge | X | X | |
| New | X |
-
Import-CvadAcToSite- 将 YAML 文件导入到云。支持创建、更新和删除操作。将所有本地文件导入到云。此命令确保云的最终状态与本地状态相同。此选项会删除云中存在的任何更改。导入的站点配置文件源自 %HOMEPATH%\Documents\Citrix\AutoConfig。请谨慎使用。
参数：
名称 描述 必需？ 类型 按组件迁移 请参阅按组件迁移。 SwitchParameters 按对象名称筛选 请参阅按对象名称筛选。 字符串列表 云访问参数 请参阅云访问参数。 SwitchParameters SourceFolder标识 %HOMEPATH%\Documents\Citrix\AutoConfig 的替代根文件夹。 字符串 Locale指定可导出的人类可读文本的语言。 字符串 Quiet禁止向控制台记录日志。 SwitchParameter DisplayLog在 cmdlet 命令完成时显示日志文件。设置为 $false可禁止显示日志。$true或$falseMerge当设置为 $true时，仅将组件添加到云站点。组件不会被删除。设置为$false可删除组件。$true或$falseAddOnly当设置为 $true时，仅添加新组件，不更新或删除现有组件。设置为$false可允许更新和删除。当此参数为$true时，Merge将被忽略。$true或$falseMergePolicies合并策略设置和筛选器。仅当正在导入的策略已存在于云 DDC 中时，才会发生合并。合并策略的结果是，云 DDC 策略除了包含其已有的设置和筛选器外，还包含任何正在导入的新设置和筛选器。请注意，当设置和筛选器发生冲突时，导入的值优先。 SwitchParameter OnErrorAction请参阅OnErrorAction 参数。 字符串 返回：
- 请参阅Cmdlet 命令返回值
-
Merge-CvadAcToSite- 将 YAML 文件导入到云。支持创建和更新操作。将本地文件合并到云，但不删除云或本地站点中的任何组件。这会保留云中已进行的更改。如果 Citrix Cloud 中存在同名组件，此命令可以修改该组件。这是自动化配置的默认导入操作。合并的站点配置文件源自 %HOMEPATH%\Documents\Citrix\AutoConfig。
参数：
名称 描述 必需？ 类型 按组件迁移 请参阅按组件迁移。 SwitchParameters 按对象名称筛选 请参阅按对象名称筛选。 字符串列表 云访问参数 请参阅云访问参数。 SwitchParameters SourceFolder标识 %HOMEPATH%\Documents\Citrix\AutoConfig 的替代根文件夹。 字符串 Locale指定可导出的人类可读文本的语言。 字符串 Quiet禁止向控制台记录日志。 SwitchParameter DisplayLog在 cmdlet 命令完成时显示日志文件。设置为 $false可禁止显示日志。$true或$falseMerge当设置为 $true时，仅将组件添加到云站点。组件不会被删除。设置为$false可删除组件。$true或$falseAddOnly当设置为 $true时，仅添加新组件，不更新或删除现有组件。设置为$false可允许更新和删除。当此参数为$true时，Merge将被忽略。$true或$falseMergePolicies合并策略设置和筛选器。仅当正在导入的策略已存在于云 DDC 中时，才会发生合并。合并策略的结果是，云 DDC 策略除了包含其已有的设置和筛选器外，还包含任何正在导入的新设置和筛选器。请注意，当设置和筛选器发生冲突时，导入的值优先。 SwitchParameter OnErrorAction请参阅OnErrorAction 参数。 字符串 返回：
- 请参阅Cmdlet 命令返回值
-
New-CvadAcToSite- 将 YAML 文件导入到云。支持创建和更新操作。将本地站点配置导入到云，但仅添加新组件。现有云站点组件既不更新也不删除。如果现有云站点组件必须保持不变，请使用此命令。
参数：
名称 描述 必需？ 类型 按组件迁移 请参阅按组件迁移。 SwitchParameters 按对象名称筛选 请参阅按对象名称筛选。 字符串列表 云访问参数 请参阅云访问参数。 SwitchParameters SourceFolder标识 %HOMEPATH%\Documents\Citrix\AutoConfig 的替代根文件夹。 字符串 Locale指定可导出的人类可读文本的语言。 字符串 Quiet禁止向控制台记录日志。 SwitchParameter DisplayLog在 cmdlet 命令完成时显示日志文件。设置为 $false可禁止显示日志。$true或$falseOnErrorAction请参阅OnErrorAction 参数。 字符串 返回：
- 请参阅Cmdlet 命令返回值
-
Sync-CvadAcToSite- 一步完成导出和导入。Sync 同时执行导出和导入。使用
SourceTargetFolder参数指定导出/导入目标文件夹。参数：
名称 描述 必需？ 类型 按组件迁移 请参阅按组件迁移 SwitchParameters 按对象名称筛选 请参阅按对象名称筛选 字符串列表 云访问参数 请参阅云访问参数 SwitchParameters SourceTargetFolder指定导出/导入目标文件夹。 字符串 Locale指定可导出的人类可读文本的语言。 字符串 AdminAddress当导出未在 Delivery Controller 上执行时，指定 Delivery Controller 的 DNS 或 IP 地址。 字符串 Quiet禁止向控制台记录日志。 SwitchParameter DisplayLog在 cmdlet 命令完成时显示日志文件。设置为 $false可禁止显示日志。$true或$falseMerge当设置为 $true时，仅将组件添加到云站点。组件不会被删除。设置为$false可删除组件。$true或$falseAddOnly当设置为 $true时，仅添加新组件，不更新或删除现有组件。设置为$false可允许更新和删除。当此参数为$true时，Merge将被忽略。$true或$falseMergePolicies合并策略设置和筛选器。仅当正在导入的策略已存在于云 DDC 中时，才会发生合并。合并策略的结果是，云 DDC 策略除了包含其已有的设置和筛选器外，还包含任何正在导入的新设置和筛选器。请注意，当设置和筛选器发生冲突时，导入的值优先。 SwitchParameter 返回：
- 请参阅Cmdlet 命令返回值
云到云 cmdlet 命令
-
Backup-CvadAcToFile- 备份云站点中的所有配置。将云配置导出到 .yml 文件。此备份可用于备份和还原过程，以还原丢失的组件。
参数：
名称 描述 必需？ 类型 按组件迁移 请参阅按组件迁移 SwitchParameters 云访问参数 请参阅云访问参数 SwitchParameters TargetFolder指定导出目标文件夹。 字符串 Locale指定可导出的人类可读文本的语言。 字符串 Quiet禁止向控制台记录日志。 SwitchParameter DisplayLog在 cmdlet 命令完成时显示日志文件。设置为 $false可禁止显示日志。$true或$falseZipResults将备份的 YAML 文件压缩到一个 zip 文件中。该文件与备份的 YAML 文件位于同一文件夹中，并具有与该文件夹相同的名称。 SwitchParameter 返回：
- 请参阅Cmdlet 命令返回值
-
Restore-CvadAcToSite- 将备份的 YAML 文件还原到云站点。此云站点可以与源云站点相同或不同。将云站点还原到以前的配置。导入的文件源自使用
-RestoreFolder参数指定的文件夹，该参数标识包含要还原到云站点的 .yml 文件的文件夹。这必须是完全限定的文件夹规范。此 cmdlet 命令可用于恢复到以前的配置或备份和还原云站点。此命令可以添加、删除和更新云站点。参数：
名称 描述 必需？ 类型 按组件迁移 请参阅按组件迁移。 SwitchParameters 按对象名称筛选 请参阅按对象名称筛选。 字符串列表 云访问参数 请参阅云访问参数。 SwitchParameters RestoreFolder标识包含要还原到云站点的 .yml 文件的文件夹。这必须是完全限定的文件夹规范。 字符串 Locale指定可导出的人类可读文本的语言。 字符串 Quiet禁止向控制台记录日志。 SwitchParameter DisplayLog在 cmdlet 命令完成时显示日志文件。设置为 $false可禁止显示日志。$true或$falseMerge当设置为 $true时，仅将组件添加到云站点。组件不会被删除。设置为$false可删除组件。$true或$falseAddOnly当设置为 $true时，仅添加新组件，不更新或删除现有组件。设置为$false可允许更新和删除。当此参数为$true时，Merge将被忽略。$true或$falseMergePolicies合并策略设置和筛选器。仅当正在导入的策略已存在于云 DDC 中时，才会发生合并。合并策略的结果是，云 DDC 策略除了包含其已有的设置和筛选器外，还包含任何正在导入的新设置和筛选器。请注意，当设置和筛选器发生冲突时，导入的值优先。 SwitchParameter OnErrorAction请参阅OnErrorAction 参数。 字符串 返回：
- 请参阅Cmdlet 命令返回值
-
Remove-CvadAcFromSite– 从云中删除组件成员。可以重置整个站点或从组件中删除成员项（例如，从目录列表中删除一个计算机目录）。这可以与
IncludeByName参数结合使用，以选择性地删除特定成员。参数：
名称 描述 必需？ 类型 按组件迁移 请参阅按组件迁移 SwitchParameters 按对象名称筛选 请参阅按对象名称筛选 字符串列表 云访问参数 请参阅云访问参数 SwitchParameters Quiet禁止向控制台记录日志。 SwitchParameter DisplayLog在 cmdlet 命令完成时显示日志文件。设置为 $false可禁止显示日志。$true或$false返回：
- 请参阅Cmdlet 命令返回值
其他基本 cmdlet 命令
-
Compare-CvadAcToSite- 将本地 .yml 文件与云配置进行比较，生成由Import、Merge或Restorecmdlet 命令所做的更改报告。参数：
名称 描述 必需？ 类型 按组件迁移 请参阅按组件迁移。 SwitchParameters 按对象名称筛选 请参阅按对象名称筛选。 字符串列表 云访问参数 请参阅云访问参数。 SwitchParameters SourceFolder标识 %HOMEPATH%\Documents\Citrix\AutoConfig 的替代根文件夹。 字符串 Locale指定可导出的人类可读文本的语言。 字符串 Quiet禁止向控制台记录日志。 SwitchParameter DisplayLog在 cmdlet 命令完成时显示日志文件。设置为 $false可禁止显示日志。$true或$falseMerge当设置为 $true时，仅将组件添加到云站点。组件不会被删除。设置为$false可删除组件。$true或$falseAddOnly当设置为 $true时，仅添加新组件，不更新或删除现有组件。设置为$false可允许更新和删除。当此参数为$true时，Merge将被忽略。$true或$falseOnErrorAction请参阅OnErrorAction 参数。 字符串 返回：
- 请参阅Cmdlet 命令返回值
精细迁移参数
按组件迁移
以下组件可以与支持它们的 cmdlet 命令一起指定。当未指定组件参数时，会自动选择 All 选项。为避免错误，建议您按以下顺序迁移组件：
AllTagsAdminRolesAdminScopesHostConnectionsMachineCatalogsStoreFrontsDeliveryGroupsApplicationGroupsApplicationFoldersApplicationsGroupPoliciesUserZonePreference
按对象名称筛选
按组件名称迁移
IncludeByName 和 ExcludeByName 参数允许通过名称在 cmdlet 命令中包含和排除组件成员。在任何受支持的 cmdlet 命令中，一次只能选择一个组件（例如，交付组）。如果组件成员同时存在于两个区域中，则排除会覆盖任何其他参数，并且日志修复列表中会记录一个条目，标识被排除的组件和成员名称。
IncludeByName 和 ExcludeByName 接受组件成员名称列表。任何名称都可以包含一个或多个通配符。支持两种类型的通配符。当任何成员名称包含特殊字符时，组件成员名称列表必须用单引号括起来。
- * 匹配任意数量的字符
- ? 匹配单个字符
IncludeByName 和 ExcludeByName 还可以接受包含成员列表的文件，其中每个成员可以是显式的或包含通配符。文件中的每一行可以包含一个成员。成员名称的开头和结尾的空格将被修剪。文件名必须以 @ 符号开头并用单引号括起来（PowerShell 要求，以便 @ 不被重新解释）。除了与成员名称混合使用外，还可以列出多个文件。
一个合并所有名称以 DgSite1 开头并包含 Home2 的交付组的示例如下：
Merge-CvadAcToSite –DeliveryGroups –IncludeByName DgSite1*,*Home2*
按交付组名称
ByDeliveryGroupName 按应用程序和应用程序组的交付组名称进行筛选。此参数始终是一个包含列表，用于根据其交付组关联来标识要包含的成员。
ByDeliveryGroupName 接受交付组名称列表。任何名称都可以包含一个或多个通配符。支持两种类型的通配符。
- * 匹配任意数量的字符
- ? 匹配单个字符
以下示例合并所有引用所有以 EastDg 开头的交付组名称的应用程序。
Merge-CvadAcToSite –Applications –ByDeliveryGroupName EastDg*
排除已禁用
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在第一次错误时停止操作。 $true或$falseTargetFolder使用指定的文件夹作为根文件夹，而不是 %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在第一次错误时停止操作。 $true或$falseTargetFolder使用指定的文件夹作为根文件夹，而不是 %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禁止向控制台记录日志。 SwitchParameter 返回：
- zip 文件及其名称和位置显示在命令提示符下。
-
Get-CvadAcStatus- 用于测试连接性并确保满足所有必备条件。返回有关工具的信息，例如版本号以及与云和连接器状态的连接性。参数：
名称 描述 必需？ 类型 云访问参数 请参阅云访问参数 SwitchParameters 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指定导出目标文件夹。 字符串 返回：
- 请参阅Cmdlet 命令返回值
-
Show-CvadAcDocument- 在默认浏览器中显示此文档。参数：
- 无。
返回：
- 在默认 Web 浏览器中显示此网页。
-
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或$false返回：
- 请参阅Cmdlet 命令返回值
-
Set-CvadAcSiteActiveStateCloud- 将云站点状态设置为活动或非活动。参数：
名称 描述 必需？ 类型 云访问参数 请参阅云访问参数 SwitchParameters SiteActive当存在时，将云站点设置为活动，从而从所有交付组中移除维护模式。当此参数不存在时，所有交付组都将设置为维护模式。 SwitchParameter IncludeByName一个列表，指定在将站点活动状态设置为活动时要包含的交付组名称。名称中支持“*”和“?”通配符。 字符串列表 ExcludeByName一个列表，指定在将站点活动状态设置为活动时要排除的交付组名称。名称中支持“*”和“?”通配符。 字符串列表 Quiet禁止向控制台记录日志。 SwitchParameter DisplayLog在 cmdlet 命令完成时显示日志文件。设置为 $false可禁止显示日志。$true或$false返回：
- 请参阅Cmdlet 命令返回值
合并多个本地站点 cmdlet 命令
有关站点合并和这些 cmdlet 命令使用方法的更多信息，请参阅将多个站点合并到一个站点。
-
New-CvadAcSiteMergingInfo- 创建站点合并前缀/后缀信息集。一开始不必知道所有前缀或后缀。它们可以通过Set-CvadAcSiteMergingInfo更新，或通过手动编辑 SiteMerging.yml 文件。 参数：名称 描述 必需？ 类型 SiteName用于标识特定站点的前缀/后缀集的名称。它可以与实际站点的名称匹配，但不是必需的。 x 字符串 站点合并参数 请参阅站点合并参数 SwitchParameters Quiet禁止向控制台记录日志。 SwitchParameter 返回：
- 无
-
Set-CvadAcSiteMergingInfo- 更新现有站点合并前缀/后缀信息集。参数：
名称 描述 必需？ 类型 SiteName用于标识特定站点的前缀/后缀集的名称。它可以与实际站点的名称匹配，但不是必需的。 x 字符串 站点合并参数 请参阅站点合并参数 SwitchParameters Quiet禁止向控制台记录日志。 SwitchParameter 返回：
- 无
-
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 Identity and Access Management 网站上创建的客户端 ID。获取所有 Rest API 身份验证所需的 bearer token 都需要此 ID。 -
Secret– 在 Citrix Cloud Identity and Access Management 网站上创建的密钥。获取所有 Rest API 身份验证所需的 bearer token 都需要此密钥。 -
CustomerInfoFileSpec– 指向客户信息文件的文件规范，用于覆盖默认位置和名称。
迁移模式参数
修改云站点配置的 cmdlet 命令（Import、Restore、Merge、New 和 Sync）支持以下额外参数，以提供更大的灵活性。
-
CheckMode– 执行导入操作，但不进行任何更改。所有预期更改在导入完成前都会报告。您可以使用此命令在导入发生前进行测试。 -
BackupFirst– 在修改云配置之前，将云内容备份到 .yml 文件。此功能默认启用。 -
Confirm– 当为 true 时，提示用户确认他们是否要更改云站点配置。Removecmdlet 命令由于其破坏性性质会显示提示。如果不需要提示（例如在自动化脚本中运行），请将其设置为 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和Templatecmdlet 命令不返回自定义结果。
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