設定檔轉移 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 快取中建立 HIVE 檔案。無論是否將 UpgradeFBRtohive 進階設定設為 'true' 或 'false'，都會出現此行為。如果設定為 false，託管應用程式會繼續使用 FBR 方法虛擬化和同步資料。但是由於 HIVE 檔案存在於使用者的託管應用程式設定檔，在「Environment Manager 個人化分析」中將無法看見包含在同步 FBR 檔案內的資料。因此，應用程式不會出現同步的情況。

若要繼續使用設定檔轉移 PowerShell 介面，必須將 UpgradeFBRtohive 進階設定設為 'true'。

如果您不想要繼續使用 HIVE 檔案，應該使用此 Ivanti Community 文件中的指令碼將檔案移除: DOC-62059.

如需瞭解更多有關 UpgradeFBRtohive 設定的資訊，請參閱進階設定。

範例

下面會顯示從託管應用程式 Notepad 的本機 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

}

擷取

{

   # Exit with an error

   [System.Environment]::Exit(1)

}

使用設定檔轉移 PowerShell 介面匯出設定檔

Export-EMPManagedAppData cmdlet 會執行將設定檔資料從託管應用程式或「應用程式群組」轉移回 Windows 設定檔的動作。

以下是可用的參數

參數 說明

-應用程式

(必要)

 要對其執行匯出的託管應用程式或託管「應用程式群組」的名稱。這是「顯示名稱」，顯示在「個人化控制台」中。

-Verbose

(選用參數)

 提供 PowerShell 命令的詳細資訊輸出以用於診斷。

相關主題

設定檔轉移