为 Microsoft Defender for Endpoint 门户访问分配基本权限

基础权限管理为现有的 Microsoft Defender for Endpoint 客户提供了两个门户访问级别:完全访问或只读访问。 使用 Microsoft Graph PowerShell 分配“安全管理员”角色以获得完全访问权限,或分配“安全读取者”角色以获得只读访问权限。 对于更细致的权限, 可以使用基于角色的访问控制。

Important

自2025年2月16日起,新的Defender for Endpoint客户只能使用Microsoft Defender统一基于角色的访问控制(RBAC)。 现有客户可以继续使用当前的权限模式。 有关详细信息,请参阅 Microsoft Defender 统一 RBAC。

先决条件

在分配用户权限前,请完成以下先决条件:

  • 确认你的组织仍然使用基本权限管理。 如果你的组织切换到了RBAC,你就不能切回基本权限。
  • 安装 Microsoft Graph PowerShell。
  • 使用分配为特权角色管理员角色的账户,或带有所需角色管理权限的自定义角色。 特权角色管理员是支持执行此操作的 Microsoft Entra 内置角色中所需权限最低的角色。
  • 使用 Connect-MgGraph(具有委派的 RoleManagement.ReadWrite.Directory 和 User.ReadBasic.All 权限)连接到 Microsoft Graph。 有关认证选项,请参见 Microsoft Graph PowerShell 认证命令。

你不需要作为本地 Windows 管理员运行 PowerShell 来通过 Microsoft Graph 分配 Microsoft Entra 角色。

了解基本的访问权限

基本权限管理提供以下访问级别:

  • 完全访问权限:用户可以登录、查看系统信息、解决警报、提交深入分析文件,并下载入职软件包。 指定 Microsoft Entra 安全管理员角色以授予完全访问权限。
  • 只读访问:用户可以登录并查看警报及相关信息。 它们无法更改警报状态,提交文件进行深入分析,或执行其他状态更改操作。 分配 Microsoft Entra 安全读取者角色,以授予只读访问权限。

使用 Microsoft Graph PowerShell 分配用户访问权限

为每个需要访问 Defender for Endpoint 的用户分配相应的 Microsoft Entra 角色。

注意

以下示例使用 directoryRole 成员资格 API。 Microsoft 推荐为新的自动化使用统一的角色分配 API。 Get-MgDirectoryRole 只返回已激活的目录角色。 如果命令没有返回请求的角色,可以在管理中心分配 Microsoft Entra 角色,或使用统一的角色分配 API。

分配完全访问权限

将 secadmin@contoso.onmicrosoft.com 替换为需要完全访问权限的账户的用户主体名称,然后运行以下命令:

New-MgDirectoryRoleMemberByRef -DirectoryRoleId (Get-MgDirectoryRole -Filter "DisplayName eq 'Security Administrator'").Id -OdataId "https://graph.microsoft.com/v1.0/directoryObjects/$((Get-MgUser -UserId 'secadmin@contoso.onmicrosoft.com').Id)"

授予只读权限

将 reader@contoso.onmicrosoft.com 替换为需要只读访问权限的帐户的用户主体名称,然后运行以下命令:

New-MgDirectoryRoleMemberByRef -DirectoryRoleId (Get-MgDirectoryRole -Filter "DisplayName eq 'Security Reader'").Id -OdataId "https://graph.microsoft.com/v1.0/directoryObjects/$((Get-MgUser -UserId 'reader@contoso.onmicrosoft.com').Id)"