powershell Intune 範例

頁面類型	產品	語言	擴充	無依賴關係
樣本	ms圖	電源外殼	內容類型 科技 服務 建立日期 樣品 微軟圖譜 因圖恩 2017 年 4 月 4 日上午 9:41:27	真的

重要的

去年，我們在這裡宣布了一個新的 Microsoft Intune GitHub 儲存庫，該儲存庫基於 Microsoft Graph SDK 的 PowerShell 模組。此舊版 Microsoft Intune PowerShell 範例腳本 GitHub 儲存庫現在是唯讀的。此外，從 2024 年 4 月 1 日開始，由於基於 Graph SDK 的 PowerShell 模組中的身份驗證方法更新，基於全域 Microsoft Intune PowerShell 應用程式（客戶端）ID 的身份驗證方法將被刪除。

這將如何影響您的組織

如果使用 Intune PowerShell 應用程式 ID (d1ddf0e4-d672-4dae-b554-9d5bdfd93547)，則需要使用 Microsoft Entra ID 註冊的應用程式 ID 更新腳本，以防止腳本損壞。

你需要做什麼準備

在 2024 年 5 月 6 日之前，透過以下方式更新您的 PowerShell 腳本：

1. 在 Microsoft Entra 管理中心建立新的應用程式註冊。有關詳細說明，請閱讀：快速入門：向 Microsoft 標識平台註冊應用程式。
2. 使用步驟 1 中建立的新應用程式 ID 更新包含 Intune 應用程式 ID (d1ddf0e4-d672-4dae-b554-9d5bdfd93547) 的腳本。

請查看“更新應用程式註冊”文件以取得詳細說明。 （https://github.com/microsoftgraph/powershell-intune-samples/blob/master/Updating%20App%20Registration）

Intune 圖表範例

此 PowerShell 範例腳本儲存庫展示如何存取 Intune 服務資源。他們透過從 PowerShell 向 Microsoft Graph API 發出 HTTPS RESTful API 請求來示範這一點。

Intune 和 Microsoft Graph 的文件可以在此處找到 Intune Graph 文件。

這些範例示範了用於管理 Intune 資源的典型 Intune 管理員或 Microsoft 合作夥伴操作。

此存儲庫中包含以下範例：

• 管理員同意
• Android企業版
• Apple註冊
• 應用領域
• 應用同步
• 應用程式保護策略
• 審計
• 驗證
• 認證機構
• 檢查狀態
• 公司入口網站品牌
• 合規政策
• 企業設備註冊
• 設備配置
• 報名限制
• Intune數據導出
• LOB_應用程式
• 受管設備
• 呼叫
• RBAC
• 遠端操作審計
• 軟體更新
• 條款與條件
• 使用者策略報告

這些腳本按“原樣”獲得許可。根據麻省理工學院的許可證。

免責聲明

某些腳本範例從您的 Intune 租用戶擷取訊息，而其他腳本範例則在您的 Intune 租用戶中建立、刪除或更新資料。在運行每個範例腳本之前了解其影響；應使用非生產或「測試」租用戶帳戶執行範例。

使用 Intune 圖形 API

Intune Graph API 允許租用戶以程式設計方式存取 Intune 訊息，並且該 API 執行與透過 Azure 入口網站提供的操作相同的 Intune 操作。

Intune 以與其他雲端服務相同的方式將資料提供到 Microsoft Graph，並提供豐富的實體資訊和關係導航。使用 Microsoft Graph 組合來自其他服務和 Intune 的訊息，為 IT 專業人員或最終用戶建立豐富的跨服務應用程式。

先決條件

使用這些 Microsoft Graph API Intune PowerShell 範例需要滿足以下條件：

• 透過從提升的 PowerShell 提示字元執行「Install-Module AzureAD」或「Intall-Module AzureADPreview」來安裝 AzureAD PowerShell 模組
• 使用生產或試用授權支援 Azure 入口網站的 Intune 租用戶 (https://docs.microsoft.com/en-us/intune-azure/introduction/what-is-microsoft-intune)
• 使用 Microsoft Graph API 設定 Intune 控制和政策需要 Intune 授權。
• 有權管理 Intune 服務的帳戶
• Windows 10 x64 上的 PowerShell v5.0（PowerShell v4.0 是腳本正常運作的最低要求）
• 注意：對於 PowerShell 4.0，您將需要 PS 4.0 的 PowershellGet 模組才能使用安裝模組功能
• 首次使用這些腳本需要租用戶的全域管理員接受應用程式的權限

入門

安裝或滿足先決條件後，執行下列步驟以使用這些腳本：

1. 腳本使用

1. 將儲存庫的內容下載到本機 Windows 計算機

• 將檔案提取到本機資料夾（例如 C:IntuneGraphSamples）
• 從開始功能表執行 PowerShell x64
• 瀏覽到目錄（例如 cd C:IntuneGraphSamples）
• 對於本機儲存庫中的每個資料夾，您可以瀏覽到該目錄，然後執行您選擇的腳本
• 應用程式腳本用法範例：
  • 若要使用管理應用程式腳本，請從 C:IntuneGraphSamples 執行“cd .Applications”
  • 進入資料夾後，執行 .Application_MDM_Get.ps1 以取得所有 MDM 新增的應用程式 此步驟序列可用於每個資料夾...

2. 使用 Microsoft Graph 進行身份驗證

第一次執行這些腳本時，系統會要求您提供一個帳戶以透過該服務進行身份驗證：

 Please specify your user principal name for Azure Authentication:

提供使用者主體名稱後，將開啟一個彈出窗口，提示您輸入密碼。使用 Azure Active Directory 成功進行驗證後，使用者代幣將持續一個小時，一旦 PowerShell 工作階段中該小時到期，系統會要求您重新進行驗證。

如果您第一次針對租戶執行該腳本，將會出現一個彈出窗口，指出：

 Microsoft Intune PowerShell needs permission to:

* Sign you in and read your profile
* Read all groups
* Read directory data
* Read and write Microsoft Intune Device Configuration and Policies (preview)
* Read and write Microsoft Intune RBAC settings (preview)
* Perform user-impacting remote actions on Microsoft Intune devices (preview)
* Sign in as you
* Read and write Microsoft Intune devices (preview)
* Read and write all groups
* Read and write Microsoft Intune configuration (preview)
* Read and write Microsoft Intune apps (preview)

注意：如果您的使用者帳戶針對基於裝置的條件訪問，則您的裝置必須註冊或符合通過身份驗證的要求。

貢獻

如果您想為此範例做出貢獻，請參閱 CONTRIBUTING.MD。

該專案採用了微軟開源行為準則。有關詳細信息，請參閱行為準則常見問題解答或聯繫 [email protected] 提出任何其他問題或意見。

問題和評論

我們很樂意收到您有關 Intune PowerShell 範例的回饋。您可以在此儲存庫的問題部分將您的問題和建議發送給我們。

您的回饋對我們很重要。在 Stack Overflow 上與我們聯絡。使用 [MicrosoftGraph] 和 [intune] 標記您的問題。

其他資源

• Microsoft Graph API 文件
• 微軟圖形門戶
• 微軟程式碼範例
• Intune 圖形文檔

版權

版權所有 (c) 2017 微軟。版權所有。

該專案採用了微軟開源行為準則。有關詳細信息，請參閱行為準則常見問題解答或聯繫 [email protected] 提出任何其他問題或意見。