使用 PowerShell 创建有关分配给用户帐户的 Teams 策略的报告

经常有人问我为什么 Microsoft 365 管理控制台省略打印选项。例如，转到 Microsoft 365 管理中心的“活动用户”部分，寻找打印用户列表的方法。没有一个。通常存在的是将数据（在本例中为用户）导出到 CSV 文件的选项。

我认为微软在管理控制台上采用这种方法有几个原因。首先，控制台页面信息进行显示。当您移动到列表底部时，会显示更多数据，直到出现完整的数据集（我从未对拥有 50,000 个用户的租户尝试过此操作，但这是理论上的）。此实现与 Graph API 获取数据的方式一致。在较大的租户中，与被迫等待所有数据可用相比，分页效果更好。其次，在所有管理控制台上实施和支持打印选项的工程工作可能是微软希望避免的成本。第三，导出选项允许租户下载信息并根据自己的要求进行格式化（所有组织都有自己的格式）。最后，通常可以通过 PowerShell 或 Graph API 以编程方式访问数据。总体而言，对于 Microsoft 365 管理控制台缺乏打印支持，很难抱怨太多。

团队政策

这让我轻松进入 Teams 并请求生成分配给用户帐户的策略报告。如您所知，Teams 非常喜欢策略。最近的检查显示有 40 个单独的 Teams 策略可以分配给一个帐户（有 16 个策略可通过 Teams 管理中心进行编辑）。除非他们涉及 Teams Phone 系统（该系统使用许多策略），否则普通 Teams 管理员可能会与以下集合进行交互：

• 会议策略：控制 Teams 会议中可用的功能。
• 消息传递策略：控制 Teams 聊天和频道消息中的功能。
• 应用程序设置策略：控制固定到应用程序导航栏的应用程序以及用户可以安装的应用程序。
• 应用程序权限策略：控制 Teams 用户可用的应用程序集。
• 增强的加密策略：控制 1:1 通话中 Teams 端到端加密的可用性。
• 更新管理策略：控制用户是否可以访问预览功能。
• 频道策略：控制用户是否可以创建新的私有和共享频道。
• 反馈策略：控制是否提示用户向 Microsoft 发送反馈调查。
• 实时事件策略：控制用户如何创建实时事件。

考虑到这组策略，我们可以编写一些 PowerShell 来生成 Teams 策略分配的报告。

报告编码

报告脚本非常简单。

• 连接到 Microsoft Teams PowerShell 模块以获取有关分配给用户的策略的信息。
• 连接到 Exchange Online 管理 PowerShell 模块。这是一个可选连接，我使用 Get-OrganizationConfig cmdlet 来获取报告的租户名称。您还可以使用 Azure AD 模块中的 Get-AzureADTenantDetail cmdlet。
• 对于每个用户，提取策略分配并更新 PowerShell 列表对象。可以轻松添加或删除策略分配来自定义输出。如果使用默认策略，我们输出“Tenant Default”（如果您愿意，您可以选择不同的名称），否则脚本将插入分配的策略的名称。
• 处理完所有用户后，使用列表数据和一些 HTML 代码创建一个 HTML 文件。
• 使用报告数据创建 CSV 文件，以便轻松分析作业。
• 最后报告成功和创建的文件的名称。

图 1 显示了报告的示例。正如您所看到的，该报告列出了每个用户的九个目标策略中每一个的分配。

您可以从 GitHub 下载该脚本。请随意修改代码以满足租户的要求。基础知识将保持不变，但您可能需要添加一些额外的策略或美化报告的格式。

贝壳的力量

该脚本的编写时间并不长（诚然，我手头有 HTML 部分）。这再次证明 PowerShell 对于 Microsoft 365 租户管理员在填补 Microsoft 留下的空白方面有多么有用。或者，换句话说，去微软选择不去的地方。享受！