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”或“Ins​​tall-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] 提出任何其他问题或意见。