配置文件迁移 PowerShell 界面

在此部分：

关于配置文件迁移 PowerShell 界面

可以编写配置文件迁移脚本，以便在数据库和客户端上的 Windows 配置文件之间导入或导出应用程序或应用程序组数据。

建议通过 Environment Manager 个性化控制台配置“配置文件迁移”。只有在需要精细控制来迁移单个应用程序或应用程序组的情况下才应使用 cmdlet，例如将数据从未分组的应用程序移动到应用程序组。Cmdlet 可协助配置文件数据的稳妥迁移，例如在同时使用多个版本的 Microsoft Office 的环境中迁移。

要将数据从未分组的应用程序迁移到应用程序组，请将应用程序导出到本地配置文件，然后再将其导入应用程序组。

PowerShell cmdlet 有以下行为：

  • 仅在个性化服务器未启用“配置文件迁移”时受支持。
  • 迁移次数与 cmdlet 执行次数一致。不会记录状态，但管理员有责任确保只有在需要时才使用它。
  • 为了确保数据完整性，只有在没有为指定应用程序或应用程序组运行应用程序实例时，才会进行迁移。
  • 错误以执行后引发异常的形式出现。

帮助

您可以输入以下命令，获取更多帮助：

get-help <cmdlet name>

加载配置文件迁移 PowerShell 模块

该模块安装在 Environment Manager 代理目录中。使用以下命令加载 PowerShell 模块：

Import-Module "C:\Program Files\AppSense\Environment Manager\Agent\EmCmdlet.dll"

如果您更改了默认安装位置，请对文件路径做出相应更改。

或者，使用以下命令从当前安装目录加载 PowerShell 模块：

Import-Module ((Get-ItemProperty 'HKLM:\SOFTWARE\AppSense\Environment Manager').ClientPath + 'EmCmdlet.dll'

使用配置文件迁移 PowerShell 界面导入配置文件

Import-EMPManagedAppData cmdlet 执行将配置文件数据从 Windows 配置文件迁移到受管应用程序配置文件中的操作。

受管应用程序配置的注册表、文件夹及文件包含项和排除项将用作导入数据的源位置。

Windows 配置文件可以是本地配置文件，也可以是存储在网络位置的漫游配置文件。

可以使用以下参数：

参数 说明
-App（强制） 要执行导入的受管应用程序或受管应用程序组的名称。此名称即为显示在“个性化控制台”中的“显示名称”。
-ProfilePath（可选） Windows 配置文件的路径，用作数据源，作为从本地配置文件导入的替代项。此路径必须是 Windows 配置文件版本不可知的路径，因此不应包含任何版本后缀。例如，\\server\share\user1.V2 的配置文件路径应该输入为 \\server\share\user1。仅支持与当前或较早操作系统匹配的配置文件版本。例如，在 Windows 7 计算机上运行时，无法从 Windows 10 配置文件导入。通过查找与当前操作系统匹配的版本，在配置的位置选择适当的配置文件。如果找不到匹配的配置文件，则会使用较早的配置文件版本。支持使用当前用户会话的特定环境变量。
-ProfileAppDataPath（如果提供 ProfilePath，则可选用此参数） 从网络配置文件导入时，如果 Roaming AppData 文件夹不在用户的配置文件位置，则可使用此参数来指定该文件夹的路径。支持使用当前用户会话的特定环境变量。
-Merge（可选开关） 如果指定，该操作会将个性化数据与 Windows 配置文件中的数据合并。个性化数据的优先级更高，不会被替换。如果未指定，该操作会在导入之前清除现有配置文件数据。
-Verbose（可选开关） 提供 PowerShell 命令的详细输出，供诊断时使用。

使用 Import-EMPManagedAppData 命令导入应用程序配置文件时，系统会在用户的受管应用程序配置文件和本地 AppSensevirtual 缓存中创建配置单元文件。无论 UpgradeFBRtohive 高级设置是设置为 'true' 还是 'false'，均会执行此行为。如果设置为 false，受管应用程序会继续使用 FBR 方法来虚拟化和同步数据。但是，由于用户的受管应用程序配置文件中存在配置单元文件，因而同步 FBR 文件中包含的数据在 Environment Manager 个性化分析中不可见。因此，应用程序可能不会同步。

要继续使用配置文件迁移 PowerShell 界面，UpgradeFBRtohive 高级设置必须设置为 'true'。

如果您不希望继续使用配置单元文件，则应使用此 Ivanti 社区文档 DOC-62059 中的脚本删除该文件。

有关 UpgradeFBRtohive 设置的详细信息，请参阅高级设置。

示例

下文显示了从受管应用程序“记事本”的本地 Windows 配置文件中导入数据的示例：

Import-Module ((Get-ItemProperty 'HKLM:\SOFTWARE\AppSense\Environment Manager').ClientPath + 'EmCmdlet.dll')

Import-EMPManagedAppData -App Notepad

下文显示了可用在 Environment Manager 策略自定义条件中的示例，其中脚本的退出代码用于确定条件是否成立：

try

{

   Import-Module ((Get-ItemProperty 'HKLM:\SOFTWARE\AppSense\Environment Manager').ClientPath + 'EmCmdlet.dll')

   Import-EMPManagedAppData -App Notepad

}

catch

{

   # Exit with an error

   [System.Environment]::Exit(1)

}

使用配置文件迁移 PowerShell 界面导出配置文件

Export-EMPManagedAppData cmdlet 执行将配置文件数据从受管应用程序或应用程序组迁移回 Windows 配置文件的操作。

可以使用以下参数

参数 说明

-App

（强制）

 要执行导出的受管应用程序或受管应用程序组的名称。此名称即为显示在“个性化控制台”中的“显示名称”。

-Verbose

（可选开关）

 提供 PowerShell 命令的详细输出，供诊断时使用。

相关主题

配置文件迁移