通知腳本命令

Jamf Connect 說明文件

Solution
Application
Jamf Connect
Content Type
技術說明文件
Utilities & Services
ft:locale
zh-TW

一般命令

以下命令通常用於顯示通知畫面,如下圖所示。
常用來顯示通知畫面的命令圖片。
Image:

此命令可以指定路徑中的影像取代預設的通知影像。該影像會自動縮放為正確大小。

範例:

Command: Image: /tmp/logo.png

MainText:
此命令可變更向使用者顯示的主要文字。
範例:

Command: MainText: Please wait while your new MacBook Pro is set up.

MainTextImage:

此命令可以指定路徑中的自訂圖示取代主要文字。影像像素可達 660 x 105,並且可按比例縮放至適當大小。

範例:

Command: MainTextImage: /tmp/logo.png

MainTitle:

此命令可變更向使用者顯示的主要標題。

範例:

Command: MainTitle: Welcome to your new MacBook Pro

互動命令

互動命令用於自訂通知處理程序期間的使用者互動,並顯示在下圖中。
Determinate:
此命令將進度列設為「確定」(逐步進行),而非顯示旋轉進度列。您必須指定您欲在通知處理程序期間使用的步驟數目。一旦設定,腳本中的每個狀態更新均會將進度列遞增一階。
範例:

Command: Determinate: 5

DeterminateManual:
此命令將進度列設為確定,並且手動添加進度,而非使用階段命令。您必須指定您在通知處理程序期間想要的步驟數目。設定後,您必須使用DeterminateManualStep:命令手動添加狀態列的進度。
範例:

Command: DeterminateManual: 5

DeterminateManualStep:
DeterminateManual:模式中時,此命令會將進度列提前一個步驟或指定間隔。下列範例會將進度列移動兩個步驟。
範例:

Command: DeterminateManualStep: 2

DeterminateOff:
此命令可停用進度列的確定狀態。已發生的步驟在進度列中將維持已完成狀態。這可讓您在確定狀態與非確定狀態間移動,而不會遺失進度。
範例:

Command: DeterminateOff:

DeterminateOffReset:
關閉進度列的確定狀態後,您必須將它重設為零。
範例:

Command: DeterminateOffReset:

Quit
此命令可結束通知處理程序。
範例:

Command: Quit

您可在通知處理程序中使用echo Status:來更新使用者。下列為狀態更新的範例:

 Status: Installing Jamf
注意:

如使用Determinate:命令,則進度列會隨著每次狀態更新而前進。

如果您使用Jamf Pro,還可以配置通知畫面從Jamf Pro為使用者讀取和顯示政策記錄檔,而不是將通知畫面記錄檔形式NotifyLogStyle)設定的值配置為jamf