排除自动配置故障和其他信息
重要的是:
有关自动配置的常见错误消息和相应的解决方案,请参阅故障排除常见问题解答在知识中心文章CTX277730。
自动配置工具错误
自动化配置工具操作有时会产生错误。当发生这种情况时,在处理诸如机器目录、交付组或组策略之类的组件时可能会发生故障。使用OnErrorAction
延续参数允许您在处理过程中捕获错误,解决它们,并从中断的地方重新开始。
默认的OnErrorAction
值是StopCompEnd
。当出现错误时,工具将完成对当前组件的处理。没有额外的组件被处理,错误也不会转移到下游的依赖组件。在解决了所有错误之后,可以在应用任何延续参数的情况下重新运行cmlet。
OnErrorAction参数
你可以定义OnErrorAction
迁移cmdlet上的参数值可以控制工具如何响应它在处理组件时发现的错误。
下表给出了参数值及其说明:
价值 | 描述 |
---|---|
继续 |
尝试处理尽可能多的所有组件。 |
暂停 |
在处理结束时暂停并提示您继续或停止。 |
StopCompEnd |
尝试处理尽可能多的组件。组件完成后停止。(默认) |
立即停止 |
当发现错误时,处理停止。 |
迁移cmdlets
你可以申请OnErrorAction
参数设置为以下迁移命令:
Compare-CvadAcToSite
Import-CvadAcToSite
Merge-CvadAcToSite
New-CvadAcToSite
Restore-CvadAcToSite
例子:Merge-CvadAcToSite -OnErrorAction立即停止
恢复参数
这些参数定义在操作暂停或因错误而停止后工具如何恢复。
您可以将恢复参数应用于包含以下内容之一的迁移cmletOnErrorAction
参数值:
暂停
StopCompEnd
立即停止
下表给出了参数值及其说明:
价值 | 描述 |
---|---|
-AllRemaining |
需要一个起始组件。处理从起始组件开始,并处理所有剩余的组件。处理多个组件。 |
的简历 |
使用来自CurrentComponent.txt的组件作为起始点。All Remaining设置为true。处理多个组件。 |
重复 |
使用来自CurrentComponent.txt的组件作为起始点。All Remaining设置为false。只处理一个组件。 |
最后处理的组件存储在AutoConfig文件夹中的CurrentComponent.txt文件中。不建议编辑此文件。如果你指定的简历
或重复
和CurrentComponent.txt丢失或无效,处理将停止,并提示您选择一个组件。
设置CustomerInfo中的OnErrorAction。yml文件
你也可以设置OnErrorAction
值。yml文件。使用以下cmdlet设置值:
- 对于新文件:
new - cvad习惯infofile -OnErrorAction继续|暂停| StopCompEnd |立即停止
- 对于已存在的文件:
set - cvad习惯infofile -OnErrorAction继续|暂停| StopCompEnd |立即停止
日志
运行任何cmdlet都会在主历史日志文件中创建一个日志文件和一个条目。所有操作日志文件都放在一个备份文件夹中。所有日志文件名都以。开头CitrixLog
,然后显示自动配置操作以及执行cmdlet的日期和时间戳。日志不会自动删除。
主历史日志位于% HOMEPATH % \ \ Citrix \ AutoConfig文档,在名为History.Log。每次cmdlet执行都会产生一个主日志条目,其中包含执行的日期、操作、结果、备份和日志文件位置。
你也可以用New-CvadAcZipInfoForSupport
cmdlet收集日志,发送给Citrix寻求支持。这个cmdlet将所有日志和.yml文件压缩到一个zip文件中。客户敏感信息(CustomerInfo.)CvadAcSecurity.yml和CvadAcSecurity.yml)不包含在zip文件中。图标。yml文件is also excluded due to its size. The zip file is placed in% HOMEPATH % \ \ Citrix \ AutoConfig文档和命名CvadAcSupport_yyyy_mm_dd_hh_mm_ss.zip,根据日期和时间戳。这个zip文件也可以作为备份。
每个日志文件包括以下内容:
- 操作名称和是否启用检查模式
- 开始和结束日期和时间
- 多个条目用于每个组件的操作和成功/失败通知
- 所采取的操作的摘要,包括所创建对象的各种计数
- 建议的修复(如适用)
- 备份文件夹位置(如适用)
- 主日志位置
- 持续时间
诊断文件
诊断文件帮助您确定和解决问题。以下文件是在运行它们的操作时创建的。的特定于操作的子文件夹中% HOMEPATH % \ \ Citrix \ AutoConfig文档。在提供问题解决支持的信息时包括这些文件。
出口
PoshSdk_yyyy_mm_dd_hh_mm_ss.ps1
该文件统计了为将站点配置导出到文件而进行的所有Broker PowerShell SDK调用。
导入,合并,还原,同步,备份,比较
Transaction_yyyy_mm_dd_hh_mm_ss.txt
该文件记录了每个Rest API调用和相关信息。
RestApiContent_yyyy_mm_dd_hh_mm_ss.txt
该文件包含所有添加
,更新
,删除
Rest API内容。
依赖关系导致的问题
由于缺少依赖项,导入和合并可能会失败。常见的问题有:
- 组策略缺少交付组过滤器。通常的原因是没有导入交付组。
- 应用程序导入或合并失败。通常的原因是缺少未导入的交付组或应用程序组。
- 应用程序组缺少一个RestrictToTag。通常的原因是没有导入标签。
- 主机连接失败。通常的原因是CvadAcSecurity中缺少安全信息。yml文件。
- 机器目录失败。通常原因是未导入主机连接。
- 机器目录和交货组中缺少的机器。通常的原因是在Active Directory中没有找到计算机。
- 交付组中缺少的用户。通常的原因是在活动目录中没有找到用户。
建议
- 一次不要运行多个自动化配置实例。在云站点中运行多个并发实例会产生不可预测的结果。如果发生这种情况,请重新运行自动化配置的一个实例,以使站点达到预期状态。
- 运行自动配置时,请勿在“完全配置”中的“管理”选项卡中工作或更改数据。
- 始终在完全配置中可视化地验证合并/导入/恢复结果,以确保云站点符合预期。
文件夹
默认文件夹根位置
所有自动配置工具操作都发生在根文件夹或其子文件夹中。根文件夹位于% HOMEPATH % \ \ Citrix \ AutoConfig文档。
出口
所有导出的文件都放在两个文件夹位置,提供了易用性和导出的历史记录。导出总是放在根文件夹中。副本放置在名为出口注明出口日期和时间。
根文件夹始终包含最近导出的本地站点配置。每一个出口子文件夹包含在指定日期和时间完成的导出,它维护导出的历史记录。你可以用任何出口子文件夹配置云站点。自动配置不会删除或修改现有的导出子文件夹。
进口/合并/同步/比较
进口
,合并
,比较
操作总是来自位于根文件夹中的文件。每个操作都会导致创建一个子文件夹,根文件夹中的文件将被复制到该子文件夹中,从而提供云站点更改源文件的历史记录。
恢复
的恢复
使用已有子文件夹对云站点进行配置。源文件夹是根据需要指定的-RestoreFolder
参数。与其他命令不同,不会创建新的子文件夹,因为恢复
操作使用已存在的子文件夹。恢复文件夹可以是根文件夹,但仍然必须在-RestoreFolder
参数。
备份
自动化配置初始化、更新和备份云站点配置。随着时间的推移,云站点上的许多不同配置可能会发生变化。为了便于长期使用和保存历史更改,Automated Configuration使用保存方案来保存这些更改的历史,并提供恢复早期状态的方法。
始终将云站点配置备份到名为备份带有备份的数据和时间。自动配置不会删除或修改现有的导出子文件夹。
您可以使用备份来恢复特定组件或整个配置。要恢复整个交付组和机器目录组件,请使用cmdlet:
Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss -DeliveryGroups - machineccatalogs
注意:
上述命令中的备份文件信息是基于您自己的备份。
要恢复整个云站点配置,使用cmdlet:
Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss
注意:
上述命令中的备份文件信息是基于您自己的备份。
更改默认根文件夹
的出口
,进口
,合并
,同步
,比较
操作步骤可以修改默认根目录-AlternateFolder
参数。每个操作子文件夹的创建和管理与前面描述的相同。
复制到子文件夹的文件
所有文件都带有。Yml "扩展名被复制到操作子文件夹中,除了以下内容:
- CustomerInfo.yml
- ZoneMapping.yml
- CvadAcSecurity.yml
自动故障安全云站点备份
在运行更改配置的操作之前,对当前云站点配置进行备份。这包括进口
,合并
,同步
,恢复
参数。备份始终位于操作子文件夹下的子文件夹中。
在…的情况下恢复
时,备份文件夹是指定文件夹的子文件夹-RestoreFolder
参数。
自动化
自动化配置工具cmdlet可以在自动化脚本中运行,无需管理员干预,方法是在cmdlet完成时取消提示并显示日志结果。您也可以通过使用CustomerInfo来设置参数。yml文件。
在云修改cmdlets中增加如下参数,以抑制提示符的显示。
确认假美元
将以下参数添加到cmdlet中,以抑制在cmdlet完成时显示日志。
-DisplayLog假美元
在cmdlets中添加以下参数,以禁止登录到PowerShell命令窗口。
安静的
作为另一种方法,可以在CustomerInfo中放置以下参数。yml文件。
确认:假
DisplayLog:假
从交付控制器以外的pc导出
自动化配置工具使用多个Citrix PowerShell sdk将本地站点配置导出为文件。这些sdk自动安装在交付控制器上,使工具无需额外操作即可在交付控制器上运行。当在非delivery Controller机器上运行时,需要安装工具所需的Citrix PowerShell sdk集。这个SDK集是Citrix Studio的一部分,可以从Citrix虚拟应用程序和桌面安装媒体安装。
注意:
无法在云连接器上运行自动配置。
转向思杰云政务和日本控制平面
Citrix Cloud Government和Japan Control Plane环境使用不同的访问点来验证和分配访问令牌。这个独特的需求适用于访问云的任何自动化配置工具。执行以下步骤,在这些环境中使用自动化配置。
- 在% HOMEPATH % \ \ Citrix \ AutoConfig文档文件夹,编辑CustomerInfo.yml。
根据您想要连接的环境,将以下一行添加到CustomerInfo。Yml(或者修改它,如果已经存在的话)。
环境:“ProductionGov”
或
环境:“ProductionJP”
现在可以在这些环境中使用自动化配置。
思杰云数据收集
有关Citrix Cloud收集哪些信息的信息,请参见思杰云服务客户内容和日志处理。
额外的资源
论坛
视频
看Citrix虚拟应用程序和桌面的自动配置工具在YouTube上。
培训
Cloud Learning Center包含构建服务部署的分步视频指南,包括本文中描述的任务。看到将Citrix虚拟应用和桌面迁移到Citrix云学习路径。