Microsoft Graph PowerShell v2 发布公开预览版 - 一半的大小，加速的自动化体验

Posted 2022-12-26 Justin-Liu

通过使用 Microsoft Graph PowerShell SDK 将 Microsoft Graph API 引入 PowerShell，自动化和管理您的 Microsoft 365 租户。专注于真正重要的事情，构建脚本来自动化您的工作，而不是担心限流、重试、重定向和身份验证。Microsoft Graph PowerShell SDK 可以处理所有这些问题，并为 Microsoft Graph 中可用的所有 REST API 提供 PowerShell 命令行。

Microsoft Graph PowerShell SDK v2 可以让我们编写更健壮、更不易出错、更清晰的脚本，加速自动化体验，并且它为更多场景提供了新的身份验证方法，使用新的成功范围代码支持解除阻塞场景，它还将在正式发布后提供脚本迁移工具，方便用户从 V1 迁移到 V2。

👉更棒的脚本

为了帮助用户编写更健壮的脚本，v1.0 和 Beta 模块将在它们的命令行中使用不同的前缀。

在编写脚本时，用户应该始终依赖 Microsoft Graph v1.0，但是，有时需要在1.0版本的特性可用之前使用beta端点进行测试或早期采用。Microsoft Graph Beta 端点和其中的任何功能仍然处于预览状态，并且可以更改，这使得 Beta 端点对于生产使用不可靠，因为它可能会在没有通知的情况下破坏现有的场景。因此，考虑到这一点，您将能够在您可能需要的任何脚本中轻松地结合生产和预览，尽可能地使用1.0版本，只在真正需要的地方使用 Beta 版本。使用前缀还可以帮助您确定在哪里使用预览功能。

因此，v1.0模块将继续使用与当前v1版本相同的命名，避免对那些在 Microsoft Graph v1.0 上运行脚本的人进行破坏性的更改，并且只会观察到 Beta 版的更改。这可以在下面的例子中看到：

	Microsoft Graph API v1.0 endpoint	Microsoft Graph API Beta endpoint
模块名	Microsoft.Graph	Microsoft.Graph.Beta
命令名	Get-MgUser	Get-MgBetaUser
实体命名空间	Microsoft.Graph.PowerShell.Models.Users	Microsoft.Graph.Beta.PowerShell.Models.Users

考虑用户混合使用 1.0 版本和 Beta 版命令的场景，例如，在Microsoft Graph v1端点中几乎所有需要的东西都可用，但有几个预览 API 仅在 Beta 版中可用，使用 Microsoft Graph PowerShell SDK v1，我们有以下内容

Connect-MgGraph
Select-MgProfile v1.0
$V1Users = Get-MgUser
Select-MgProfile beta
$BetaDriveActivity = Get-MgDriveActivity

如上所示，在脚本中间很容易忽略命令行正在使用 Microsoft Graph Beta API。使用 Microsoft Graph PowerShell v2，用户可以通过以下方式实现相同的结果：

Connect-MgGraph
$V1Users = Get-MgUser
$BetaDriveActivity = Get-MgBetaDriveActivity

👉加速自动化体验

SDK 的大小缩小了58%，用户可以通过新的 Microsoft Graph PowerShell v2 版本选择更适合需求的模块。第一个是 Microsoft.Graph 模块，它指向 https://graph.microsoft.com/v1.0/，即发布版。第二个是 Microsoft.Graph.Beta，它指向 https://graph.microsoft.com/beta，即 Beta 版本。

用户可以只加载特定模块的内容而不是整个 SDK 来进一步优化脚本。

Import-Module Microsoft.Graph.Users
Connect-MgGraph
$V1Users = Get-MgUser

PowerShell 用户将可以访问更小的软件包，这将促进其管理，并显著加快 SDK 的安装，受益于 (但不限于) Azure上的 CI/CD 管道和自动化。在使用针对 Microsoft Graph v1 端点的模块时，SDK的安装大小最多减少了58%。

Microsoft Graph PowerShell SDK 的版本	包大小	安装大小
Microsoft.Graph V1.19.0	147.57 MB	855.81 MB
Microsoft.Graph V2 预览版	64.97 MB (-55.97%)	351.31 MB (-58.95%)
Microsoft.Graph.Beta V2 预览版	112.72 MB (-23.63%)	651.31 MB (-23.89%)

本篇就介绍到这里，感谢阅读