所有指令碼
適用於: macOS 和 Windows 裝置
在管理 > 指令碼和檔案 > 所有指令碼頁面中,Ivanti Neurons for MDM 允許具有系統管理角色的使用者建立或上傳及管理可用於配置並發佈到裝置的指令碼。 您可以在自訂屬性和指令碼之間建立關聯,然後將所產生的值指派給已設定的裝置。 使用稽核追蹤來檢視指令碼變更的記錄,並使用裝置詳細資料頁面來檢視執行結果。
您可以編寫指令碼來設置裝置上的任何設定。 例如,您可以執行指令碼以實現:
- 強制裝置使用者每月變更其密碼;
- 在閒置 5 分鐘後鎖定螢幕;或
- 設定安全的 Wi-Fi 網路。
本節包含以下各主題:
新增指令碼
您可以建立或上傳 bash 指令碼 (適用於 macOS) 和 ps1 指令碼 (適用於 Windows) 的存放庫。 此儲存庫可以用於組態,以選擇指令碼並根據組態中的指定排程發佈至裝置上執行。
例如,您可以建立 Shell 指令碼以在裝置上執行。 必要時,您可使用包裝函式。 不支援從殼層指令碼中執行二進位檔。
Ivanti 強烈建議您先測試自己的殼層指令碼,然後才在裝置上執行它們,以確保它們的健全性和品質。 在本機執行您的指令碼,並更正所產生的任何錯誤。
程序
- 前往管理員 > 指令碼 > 所有指令碼。
- 按一下 +新增。
- 輸入指令碼的名稱和說明。
- 在平台類型下,選取 macOS 或 Windows。
- 選取下列指令碼類型之一:
- bash
- zsh
- python
- swift
- ps1
- 選擇以 root 身分執行選項,以在裝置上以 root 身分執行指令碼。 預設清除此選項。
- 在指令碼編輯器中,可以在文字方塊內輸入、拖放或複製並貼上指令碼。
- 或者,按一下從指令碼匯入代碼以拖放現有指令碼檔案,或按一下「選擇檔案」以瀏覽並選擇要上傳至 Ivanti Neurons for MDM 的指令碼檔案。 這將會取代指令碼編輯程式中的任何現有指令碼。 此動作無法取消。 按一下匯入。 所上傳指令碼的代碼將會顯示在指令碼編輯程式中。
- (選擇性) 在自訂可用屬性區段中,選擇一或多個顯示的裝置自訂屬性,以便在它們和指令碼之間建立關聯。 它們可以用於將所產生的指令碼執行值指派給所設定裝置的裝置自訂屬性。 按一下自訂屬性的範例代碼,以檢視在指令碼中使用自訂屬性的範例代碼。
- 按一下儲存。
指令碼中的自訂屬性應使用小寫。 如果自訂屬性獲得任何指令碼的參照,則該屬性將無法移除。 當您修改自訂屬性 (例如名稱),而它與某個指令碼相關聯,則您應該要在相關聯的指令碼中進行對應變更。
修改指令碼
若要編輯或移除指令碼:
- 前往管理員 > 指令碼 > 所有指令碼。
- 在指令碼的動作欄位中,按一下對應圖示以編輯或刪除動作。
- 遵循畫面指示以完成動作。
當指令碼 (內容、名稱、描述) 變更時,指令碼的所有關聯配置都會重新發佈至裝置。
使用指令碼變數 (適用於 Windows 和 macOS)
在指令碼儲存庫中定義並儲存指令碼輸入,例如環境和替換變數。 在適用於 macOS 的 Mobile@Work 組態或適用於 Windows 指令碼和動作的 Ivanti Bridge 組態中,視連結的指令碼而定,相關的指令碼變數將可視需要供使用。 對於 macOS,此功能需要 Mobile@Work for macOS 1.71.0 及以上版本,最高支援至 Ivanti Neurons for MDM 所支援的最新發行版本。 對於 Windows,此功能需要 Ivanti Bridge。
請使用變數,在每次指令碼執行時以不同的值執行它。 例如,管理員可建立指令碼,以使用 $ 環境變數做為指令碼變數,並使其與適用於 macOS 的 Mobile@Work 指令碼組態或 Windows 組態產生關聯。 將該組態發佈並安裝至每一台使用者裝置後,Ivanti Neurons for MDM 便會針對每台裝置傳送一個不同的已註冊使用者電子郵件地址來執行特定動作。 Ivanti Neurons for MDM 管理入口網站支援自訂變數。
如要新增指令碼變數:
- 前往管理員 > 指令碼 > 所有指令碼。
- 在「指令碼輸入」區段中,按一下 +新增。
- 在「新增指令碼輸入 - 環境變數」快顯頁面中,輸入下列詳細資料:
- 要顯示的標籤 - 在適用於 macOS 的 Mobile@Work 指令碼配置頁面中,此文字將會顯示為標籤。 例如,輸入作業系統資料夾、輸入 Apache 編號等等。
- 環境變數名稱 - 例如,JAVA_HOME、OS_VERSION 等等。 在將配置詳細資料傳送至目標裝置時,Ivanti Neurons for MDM 會替換掉指令碼變數的值,因為這些值將保留在資料庫中。
- 環境變數預設值 - 例如,1024、bin/java、$ 等等。 輸入變數將會用在管理員所上傳或編輯的指令碼中。 另請參閱下面的附註。
在預覽區中,檢視環境變數的值將如何顯示成配置頁面上的指令碼輸入。
- 按一下儲存。
如此一來,只有標籤和預設值可用於配置,而非提供抽象層的環境變數名稱。
- 可接受英數字元值 (例如,1024、bin/java、root@localhost) 或系統屬性 (例如,$) 做為環境變數的值。
- 在配置頁面中進行部署時,可修改或刪除環境變數的值。
- 如果沒有提供環境變數的值,請確定在指令碼部署期間已提供值。 否則,將會傳送空白值至指令碼。
- 在裝置上發佈並安裝指令碼組態後,在管理 > 指令碼和檔案 > 所有指令碼頁面中編輯環境變數不會影響與指令碼關聯的現有組態。 另請參閱適用於 macOS 的 Mobile@Work 指令碼組態。 對於 Windows,請參閱 適用於 Windows 指令碼和動作的 Ivanti Bridge 組態。
編輯指令碼變數
如要修改指令碼變數,請對該變數按一下編輯 (鉛筆) 圖示並儲存變更。
如果指令碼配置參照至具有指令碼變數的指令碼,則對現有指令碼變數之標籤所做的編輯,也會反映在指令碼配置中。 不過:
- 指令碼變數預設值中的變更並不會反映在現有的配置中。
- 指令碼變數預設值中的變更將會反映在使用先前指令碼建立的任何新配置中。
刪除指令碼變數
如要刪除指令碼變數,請對該變數按一下刪除 (減號) 圖示並確認。
新建立的指令碼變數或者刪除現有的指令碼變數,甚至會反映在已經存在的配置中。
測試指令碼
在裝置上測試指令碼之前,請先在偵錯工具中對其進行快速測試執行,且無需儲存。
必要條件
- 對於 macOS,此功能需要適用於macOS 1.67 到Ivanti Neurons for MDM 支援之最新發行版本的 Mobile@Work。
- 對於 Windows,此功能需要 適用於 Windows 指令碼和動作的 Ivanti Bridge 組態。
程序
- 前往管理員 > 指令碼 > 所有指令碼。
- 在指令碼編輯程式中,新增或匯出指令碼。
- 如果租戶有多個空間,可選擇其中一個空間。
- 在「測試指令碼」區段中,選擇 macOS 或 Windows 做為平台。
- 在選擇裝置文字欄位中,尋找並選擇要測試指令碼的裝置。 可依序號、使用者名稱、裝置名稱和作業系統版本來搜尋裝置。
- 按一下立即測試。 如此一來,即可新增、編輯及刪除環境變數,且可使用該狀態測試指令碼 (甚至無需儲存已做的變更)。 對於 Windows 指令碼,畫面上會出現快顯,表示指令碼執行將開始,而且您可以在一段時間後從裝置詳細資料記錄索引標籤檢視狀態。
- 按一下儲存。
- 對於 macOS,等待指令碼被推送至裝置並執行。
- 在「指令碼輸入」、「指令碼輸出」和「自訂屬性」等區段中檢視發佈的測試結果。 環境變數的預設值也會顯示。
驗證指令碼執行結果
若要檢視指令碼執行結果日誌:
- 前往裝置。
- 按一下裝置的名稱。
- 按一下日誌索引標籤。
- 在「指令碼執行」動作顯示列中,您可以驗證下列資訊:
- 「詳細資料」欄位中的指令碼名稱。
- 「指令碼」欄位中的指令碼執行狀態。
- 「日期」欄位中的指令碼執行日期和時間。
- 指令碼執行日誌 (裝置日誌 plist) - 按一下「動作」欄位中的眼睛圖示。
使用篩選來顯示指令碼執行列。 這些資料列的日誌包含標準輸出的輸出 (plist) 和指令碼的標準錯誤。
- 使用篩選來顯示指令碼執行結果處理列。 這些資料列的日誌包含有關結果處理方式的詳細資料 (plist)。
- 如果指令碼沒有相關聯的自訂屬性,則系統不會處理任何結果。 這類指令碼將不會顯示在已篩選資料列的清單中。
- 如果指令碼有相關聯的自訂屬性,而且它們使用預期格式,則在結果中將會出現對應的自訂屬性,而且狀態將顯示為「成功」。 您可以在屬性索引標籤中驗證對應的自訂屬性和屬性值。
- 如果指令碼有相關聯的自訂屬性,但它們未使用預期格式,則在結果中將不會出現對應的自訂屬性,而且狀態將顯示為「錯誤」。
- 如果結果格式正確但在結果中並未收到所有的相關聯自訂屬性,則狀態將顯示為「錯誤」。
- 如果指令碼變數與指令碼一起傳送,「指令碼執行結果處理」日誌中將會包含指令碼變數的詳細資料 (plist)。
相關主題:
