使用殼層指令碼來擴充 Intune 中的裝置管理功能,超出 macOS 作業系統支援的範圍。
注意事項
需要 Rosetta 2 才能在 Apple Silicon Mac 上執行 x64 (Intel) 版本的應用程式。 若要在 Apple Silicon Mac 上自動安裝 Rosetta 2,請在 Intune 中部署殼層指令碼。 若要檢視範例指令碼,請參閱 Rosetta 2 安裝指令碼。
必要條件
撰寫殼層指令碼並將其指派給 macOS 裝置時,請確保符合下列先決條件。
- 裝置執行 macOS 12.0 或更新版本。
- Intune 會管理裝置。
- 裝置直接連線至網際網路。 Intune 不支援透過 Proxy 連線。
- 殼層指令碼的開頭
#!為 ,且位於有效位置,例如#!/bin/sh或#!/usr/bin/env zsh。 - 已安裝適用 Shell 的命令列解譯器。
使用殼層指令碼前的重要考量
- 殼層指令碼要求 Microsoft Intune 管理代理程式成功安裝在 macOS 裝置上。 如需詳細資訊,請參閱適用於 macOS 的 Microsoft Intune 管理代理程式。
- Shell 指令碼會以個別的程序方式在裝置上平行執行。
- 以登入使用者身分執行的殼層指令碼,會針對執行時裝置上所有目前已登入的使用者帳戶執行。
- 使用者必須登入裝置,才能執行以登入使用者身分執行的指令碼。
- 如果指令碼需要進行標準使用者帳戶無法進行的變更,則需要 root 使用者權限。
- 在某些情況下,殼層指令碼會嘗試比所選指令碼頻率更頻繁地執行,例如如果磁碟已滿、儲存位置遭到竄改、本機快取遭到刪除,或是 Mac 裝置重新啟動。
- 執行超過 60 分鐘的殼層指令碼會停止並回報為 失敗。
建立並指派殼層指令碼原則
依平台>選取裝置、>macOS>、管理裝置>、指令碼、>新增。
在 [基本] 中,輸入下列屬性,然後選取 [下一步]:
- 名稱:輸入殼層指令碼的名稱。
- 描述:輸入殼層指令碼的描述。 建議您使用此選擇性設定。
在 指令碼設定中,輸入下列屬性,然後選取 [下一步]:
- 上傳指令碼:瀏覽至殼層指令碼。 指令檔的大小必須小於 1 MB。
- 以登入使用者身分執行指令碼:選取 [是],以在裝置上使用使用者的認證執行指令碼。 選擇 No (預設) 以 root 使用者身分執行指令碼。
- 在裝置上隱藏指令碼通知: 預設情況下,會針對每個執行的指令碼顯示指令碼通知。 使用者會在 macOS 裝置上看到 IT 正在從 Intune 設定您的電腦 通知。
- 指令碼頻率: 選取指令碼執行的頻率。 選擇 [ 未設定] (預設) 只執行指令碼一次。 具有頻率集的指令碼也會在裝置重新啟動後執行。
- 指令碼失敗時的最大重試次數: 選取指令碼傳回非零的結束碼時應該執行的次數 (零表示成功) 。 選擇 [ 未設定] (預設) 以在指令碼失敗時不重試。
在 [範圍標記] 中,選擇性地新增指令碼的範圍標記,然後選取 [下一步]。 使用範圍標記來決定誰可以看到 Intune 中的指令碼。 如需詳細資訊,請參閱 針對 分散式 IT 使用角色型存取控制和範圍標籤。
選取 作業>選取要包含的群組。 顯示 Microsoft Entra 群組的現有清單。 選取一或多個要接收指令碼的使用者或裝置群組。 選擇 [選取]。 您選擇的群組會顯示在清單中。 他們會收到您的指令碼原則。
注意事項
指派給使用者群組的殼層指令碼可套用至登入 Mac 的任何使用者。 更新殼層指令碼的指派也會更新 適用於 macOS 的 Microsoft Intune MDM 代理程式的指派。
在 [檢閱 + 新增] 中,會顯示您所設定之設定的摘要。 選取 [ 新增] 以儲存指令碼。 當您選取 [新增] 時,指令碼原則便會部署至您選擇的群組。
您建立的指令碼現在會出現在指令碼清單中。 如有需要,您可以在將 macOS 殼層指令碼上傳至 Intune 之後檢視其內容。
監視殼層指令碼原則
您可以選擇下列其中一個報告,來監視使用者和裝置所有指派指令碼的執行狀態:
- 指令碼>選取要監視>的指令碼裝置狀態
- 指令碼>選取要監視>的指令碼使用者狀態
重要事項
無論選取的 指令碼頻率為何,只有在狀態與上次報告變更時,才會報告指令碼執行狀態。 例如,如果指令碼在一次執行中報告 成功 ,在下一次執行中報告 失敗 ,則 Intune 會使用目前的執行資訊更新狀態和上次更新時間戳記。 如果指令碼狀態未在同步處理期間變更,Intune 會從初次執行起每七天更新上次更新的時間戳記。
指令碼執行時會傳回下列其中一種狀態:
- 指令碼執行狀態 [失敗 ] 表示指令碼傳回非零的結束代碼,或指令碼格式不正確。
- 指令碼執行狀態 [成功 ] 表示指令碼作為結束代碼傳回零。
使用記錄收集對 macOS 殼層指令碼原則進行疑難排解
您可以收集裝置記錄,協助針對 macOS 裝置上的指令碼問題進行疑難排解。
記錄收集的需求
若要在 macOS 裝置上收集記錄,您必須提供下列資訊:
- 完整的絕對記錄檔路徑。
- 檔案路徑僅以分號 (;) 分隔。
- 記錄集合大小上限為 60 MB (壓縮) 或 25 個檔案,以先發生者為準。
- 允許用於記錄收集的檔案類型包括下列副檔名: .log、.zip、.gz、.tar、.txt、.xml、.crash .rtf。
收集裝置記錄
移至 [裝置>] [管理裝置>] [指令碼和補救措施]> [平台指令碼],然後選取 macOS 殼層指令碼。
在 [裝置狀態 ] 或 [使用者狀態 報告] 中,選取裝置。
選取 [收集記錄] ,然後輸入記錄檔案的資料夾路徑,路徑之間只以分號 (;) 分隔,路徑之間不得有空格或換行符。
例如,將多個路徑寫為
/Path/to/logfile1.zip;/Path/to/logfile2.log。重要事項
使用逗號、句號、換行符或引號加或不帶空格來分隔多個記錄檔路徑會導致日誌收集錯誤。 請勿在路徑之間使用空格做為分隔符號。
選取 [確定]。 裝置上的 Intune 管理代理程式會在下次簽入 Intune 時收集記錄。 此簽入通常每 8 小時進行一次。
注意事項
- 裝置會加密收集的記錄檔、傳輸記錄檔,並將它們儲存在 Microsoft Azure 儲存體中 30 天。 Microsoft Intune 系統管理中心會視需要解密並下載儲存的記錄。
- 除了系統管理員指定的記錄檔,Intune 管理代理程式也會從下列資料夾收集記錄檔:
/Library/Logs/Microsoft/Intune和~/Library/Logs/Microsoft/Intune。 代理記錄檔名稱為IntuneMDMDaemon date--time.log和IntuneMDMAgent date--time.log。 - 如果有任何系統管理員指定的檔案遺失或副檔名錯誤,請在 中尋找
LogCollectionInfo.txt這些檔案名稱。
記錄收集錯誤
記錄收集可能因為以下任何原因而失敗。 若要解決這些錯誤,請遵循補救步驟。
| 十六進位) (錯誤碼 | 錯誤碼 (12 月) | 錯誤訊息 | 補救步驟 |
|---|---|---|---|
| 0X87D300D1 | 2016214834 | 記錄檔大小不能超過 60 MB。 | 確定壓縮記錄檔的大小小於 60 MB。 |
| 0X87D300D1 | 2016214831 | 提供的記錄檔路徑必須存在。 系統使用者資料夾對於記錄檔案來說是無效的位置。 | 確保提供的檔案路徑有效且可存取。 |
| 0X87D300D2 | 2016214830 | 記錄集合檔案上傳失敗,因為上傳 URL 已過期。 | 重試收集 記錄 動作。 |
| 0X87D300D3、0X87D300D5、0X87D300D7 | 2016214829, 2016214827, 2016214825 | 記錄集合檔案上傳失敗,因為加密失敗。 重試記錄上傳。 | 重試收集 記錄 動作。 |
| 2016214828 | 記錄檔數目超過允許的 25 個檔案限制。 | 您一次最多只能收集 25 個記錄檔。 | |
| 0X87D300D6 | 2016214826 | 記錄集合檔案上傳失敗,因為 zip 錯誤。 重試記錄上傳。 | 重試收集 記錄 動作。 |
| 2016214740 | 無法加密記錄,因為找不到壓縮的記錄。 | 重試收集 記錄 動作。 | |
| 2016214739 | 記錄已收集,但無法儲存。 | 重試收集 記錄 動作。 |
macOS 的自訂屬性
您可以建立自訂屬性設定檔,讓您能夠使用 Shell 指令碼從受管理的 macOS 裝置收集自訂屬性。
建立並指派 macOS 裝置的自訂屬性
依平台>選取裝置>macOS>組織裝置> macOS>的自訂屬性新增。
在 [基本] 中,輸入下列屬性,然後選取 [下一步]:
- 名稱:輸入指令碼的名稱。
- 描述:輸入指令碼的描述。 這是選擇性設定,但建議進行。
在 [屬性設定] 中,輸入下列屬性,然後選取 [下一步]:
- 屬性的資料類型:選取指令碼傳回結果的資料類型。 可用的值為 String、Integer 和 Date。
- 指令碼:選取指令檔。
其他詳細資料:
- 殼層指令碼必須回應要報告的屬性,而且輸出的資料類型必須符合自訂屬性設定檔中屬性的資料類型。
- 殼層指令碼傳回的結果必須為 20 KB 或更少。
注意事項
使用
Date類型屬性時,請確保殼層指令碼以 ISO-8601 格式傳回日期。 請參閱下列範例。若要列印符合 ISO-8601 的日期與時區:
#!/bin/sh var=$(date +"%Y-%m-%dT%H:%M:%S%z") echo $var # Prints an ISO-8601 compliant date with time-zone若要以 UTC 時間列印符合 ISO-8601 標準的日期:
#!/bin/sh var=$(date -u +"%Y-%m-%dT%H:%M:%SZ") echo $var # Prints an ISO-8601 compliant date in UTC time在 [作業] 中,選取 選取要包含的群組。 當您選擇 [選取要包含的群組] 時,會顯示現有的 Microsoft Entra 群組清單。 選取一或多個要接收指令碼的使用者或裝置群組。 選擇 [選取]。 您選擇的群組會顯示在清單中。 他們會收到您的指令碼原則。
或者,您可以在 [指派] 旁的下拉式方塊中選取其中一個選項,以選取 [所有使用者]、[所有裝置] 或 [所有使用者和所有裝置]。
注意事項
指派給使用者群組的指令碼會套用至登入 Mac 的任何使用者。
在 [檢閱 + 新增] 中,會顯示您所設定之設定的摘要。 選取 [ 新增] 以儲存指令碼。 當您選取 [新增] 時,指令碼原則便會部署至您選擇的群組。
您建立的指令碼現在會出現在自訂屬性清單中。 將自訂屬性上傳到 Intune 之後,再檢視其內容。
監視自訂屬性原則
您可以選擇下列其中一個報告,來監視使用者和裝置所有指派自訂屬性設定檔的執行狀態:
- 自訂屬性>選取要監視>的自訂屬性設定檔裝置狀態
- 自訂屬性>選取要監視>的自訂屬性設定檔使用者狀態
重要事項
自訂屬性設定檔中提供的殼層指令碼在受管理的 Mac 上每 8 小時執行一次,並報告其狀態。
當自訂屬性設定檔執行時,會傳回下列其中一種狀態:
- 狀態 「失敗 」表示指令碼傳回非零的結束代碼,或指令碼格式不正確。 錯誤會在 [結果 ] 欄中報告。
- 狀態 為 [成功 ] 表示指令碼已傳回零作為結束代碼。 指令碼回應的輸出會在 [結果 ] 欄中報告。
常見問題集
為什麼指派的 Shell 指令碼未在裝置上執行?
造成此問題的原因有幾個:
- 代理程式可能需要簽入以接收新的或更新的指令碼。 此簽入程序每 8 小時進行一次,與 MDM 簽入不同。 確保裝置已喚醒並連線到網路,以便代理程式簽入成功,並等待代理程式簽入。 您也可以要求使用者在 Mac 上開啟公司入口網站、選取裝置,然後選取 [檢查設定]。
- 可能尚未安裝代理程式。 檢查代理程式是否安裝
/Library/Intune/Microsoft Intune Agent.app在 macOS 裝置上。 - 代理程式可能不在狀況良好狀態。 代理程式會嘗試復原 24 小時,自行移除,如果殼層指令碼仍在指派中,則會重新安裝。
指令碼執行狀態會多久報告一次?
指令碼執行完成時,指令碼執行狀態會立即回報給 Microsoft Intune 系統管理中心。 如果指令碼已排定以設定的頻率定期執行,則只會在第一次執行時回報狀態。
何時會再次執行殼層指令碼?
當指令碼傳回非零的結束代碼時,Intune 會根據 [如果指令碼失敗,則重試的最大次數] 設定來重試。 如果該設定為 [未設定],Intune 不會重試失敗的執行,並將狀態回報為失敗。 具有已設定頻率的指令碼也可以按計劃或在裝置重新啟動後再次執行。
殼層指令碼需要哪些 Intune 角色權限?
您指派的 Intune 角色需要裝置設定權限,才能刪除、指派、建立、更新或讀取殼層指令碼。
已知問題
- 無指令碼執行狀態: 如果裝置收到指令碼,但在報告執行狀態之前離線,裝置就不會在系統管理中心報告指令碼的執行狀態。
其他資訊
當您從 Microsoft Intune 為 macOS 裝置部署殼層指令碼或自訂屬性時,您會部署在 Apple Silicon Mac 電腦上原生執行之 Intune 管理代理程式應用程式的新通用版本。 相同的部署會在 Intel Mac 電腦上安裝 x64 版本的應用程式。
您需要 Rosetta 2 才能在 Apple Silicon Mac 上執行 x64 (Intel) 版本的應用程式。 若要在 Apple Silicon Mac 上自動安裝 Rosetta 2,您可以在 Intune 中部署殼層指令碼。 若要檢視範例指令碼,請參閱 Rosetta 2 安裝指令碼。