macOSEndpointProtectionConfiguration 资源类型

命名空间:microsoft.graph

重要: /beta 版本下的 Microsoft Graph API 可能会更改;不支持生产使用。

注意:适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证

MacOS 终结点保护配置文件。

继承自 deviceConfiguration

方法

方法 返回类型 说明
列出 macOSEndpointProtectionConfigurations macOSEndpointProtectionConfiguration 集合 列出 macOSEndpointProtectionConfiguration 对象的属性和关系。
获取 macOSEndpointProtectionConfiguration macOSEndpointProtectionConfiguration 读取 macOSEndpointProtectionConfiguration 对象的属性和关系。
创建 macOSEndpointProtectionConfiguration macOSEndpointProtectionConfiguration 创建新的 macOSEndpointProtectionConfiguration 对象。
删除 macOSEndpointProtectionConfiguration 删除 macOSEndpointProtectionConfiguration
更新 macOSEndpointProtectionConfiguration macOSEndpointProtectionConfiguration 更新 macOSEndpointProtectionConfiguration 对象的属性。

属性

属性 类型 说明
id String 实体的键。 继承自 deviceConfiguration
lastModifiedDateTime DateTimeOffset 上次修改对象的日期/时间。 继承自 deviceConfiguration
roleScopeTagIds 字符串集合 此实体实例的范围标记列表。 继承自 deviceConfiguration
supportsScopeTags 布尔值 指示基础设备配置是否支持分配范围标记。 如果此值为 false,并且实体对限定范围的用户不可见,则不允许向 ScopeTags 属性分配。 这发生在 Silverlight 中创建的旧策略,可以通过在 Azure 门户中删除并重新创建策略来解决。 此属性是只读的。 继承自 deviceConfiguration
deviceManagementApplicabilityRuleOsEdition deviceManagementApplicabilityRuleOsEdition 此策略的 OS 版本适用性。 继承自 deviceConfiguration
deviceManagementApplicabilityRuleOsVersion deviceManagementApplicabilityRuleOsVersion 此策略的 OS 版本适用性规则。 继承自 deviceConfiguration
deviceManagementApplicabilityRuleDeviceMode deviceManagementApplicabilityRuleDeviceMode 此策略的设备模式适用性规则。 继承自 deviceConfiguration
createdDateTime DateTimeOffset 创建对象的日期/时间。 继承自 deviceConfiguration
description String 管理员提供的设备配置的说明。 继承自 deviceConfiguration
displayName String 管理员提供的设备配置的名称。 继承自 deviceConfiguration
version Int32 设备配置的版本。 继承自 deviceConfiguration
gatekeeperAllowedAppSource macOSGatekeeperAppSources 确定应用可在 macOS 设备上从哪些下载位置运行的系统和隐私设置。 可能的值是:notConfiguredmacAppStoremacAppStoreAndIdentifiedDevelopersanywhere
gatekeeperBlockOverride 布尔值 如果设置为 true,则将禁用 Gatekeeper 的用户替代。
firewallEnabled 布尔值 是否应启用防火墙。
firewallBlockAllIncoming 布尔值 对应于“阻止所有传入连接”选项。
firewallEnableStealthMode 布尔值 对应于“启用隐藏模式”。
firewallApplications macOSFirewallApplication 集合 具有防火墙设置的应用程序列表。 不在此列表上的应用程序的防火墙设置由用户确定。 该集合最多可包含 500 个元素。
fileVaultEnabled 布尔值 是否应启用 FileVault。
fileVaultSelectedRecoveryKeyTypes macOSFileVaultRecoveryKeyTypes 如果启用了 FileVault,则需要确定要使用的恢复密钥的类型 () 。 . 可取值为:notConfiguredinstitutionalRecoveryKeypersonalRecoveryKey
fileVaultInstitutionalRecoveryKeyCertificate 二进制 如果所选恢复密钥类型 () 包括 InstitutionalRecoveryKey,则是必需的。 用于设置机构恢复密钥的 DER 编码证书文件。
fileVaultInstitutionalRecoveryKeyCertificateFileName String 要显示在 UI 中的机构恢复密钥证书的文件名。 (*.der) 。
fileVaultPersonalRecoveryKeyHelpMessage String 如果所选恢复密钥类型 () 包括 PersonalRecoveryKey,则是必需的。 向用户显示的简短消息,说明他们如何检索其个人恢复密钥。
fileVaultAllowDeferralUntilSignOut 布尔值 可选。 如果设置为 true,用户可以延迟启用 FileVault,直到注销。
fileVaultNumberOfTimesUserCanIgnore Int32 可选。 使用“延迟”选项时,这是用户在需要 FileVault 登录之前可以忽略启用 FileVault 的提示的最大次数。 如果设置为 -1,它将始终提示启用 FileVault,直到启用 FileVault,不过它将允许用户绕过启用 FileVault。 将此设置为 0 将禁用该功能。
fileVaultDisablePromptAtSignOut 布尔值 可选。 使用“延迟”选项时,如果设置为 true,则不会提示用户在注销时启用 FileVault。
fileVaultPersonalRecoveryKeyRotationInMonths Int32 可选。 如果所选恢复密钥类型 () 包括 PersonalRecoveryKey,则轮换该密钥的频率(以月为单位)。
fileVaultHidePersonalRecoveryKey 布尔值 可选。 在 FileVault 加密期间,隐藏的个人恢复密钥不会出现在用户的屏幕上,从而降低它最终落入错误之手的风险。
advancedThreatProtectionRealTime 支持 确定是否在 macOS 上为Microsoft Defender高级威胁防护启用实时保护。 可取值为:notConfiguredenableddisabled
advancedThreatProtectionCloudDelivered 支持 确定是否为 macOS 上的Microsoft Defender高级威胁防护启用云提供的保护。 可取值为:notConfiguredenableddisabled
advancedThreatProtectionAutomaticSampleSubmission 支持 确定是否在 macOS 上为Microsoft Defender高级威胁防护启用自动文件示例提交。 可取值为:notConfiguredenableddisabled
advancedThreatProtectionDiagnosticDataCollection 支持 确定是否为 macOS 上的Microsoft Defender高级威胁防护启用诊断和使用情况数据收集。 可取值为:notConfiguredenableddisabled
advancedThreatProtectionExcludedFolders 字符串集合 要从Microsoft Defender macOS 上的高级威胁防护的防病毒扫描中排除的文件夹的路径列表。
advancedThreatProtectionExcludedFiles 字符串集合 要从防病毒扫描中排除的文件的路径列表,用于 macOS 上的高级威胁防护Microsoft Defender。
advancedThreatProtectionExcludedExtensions 字符串集合 要从防病毒扫描中排除Microsoft Defender macOS 高级威胁防护的文件扩展名列表。
advancedThreatProtectionExcludedProcesses 字符串集合 要从防病毒扫描中排除的进程名称列表Microsoft Defender macOS 上的高级威胁防护。

关系

关系 类型 说明
groupAssignments deviceConfigurationGroupAssignment 集合 设备配置文件的组分配列表。 继承自 deviceConfiguration
assignments deviceConfigurationAssignment 集合 设备配置文件的分配列表。 继承自 deviceConfiguration
deviceStatuses deviceConfigurationDeviceStatus 集合 按设备的设备配置安装状态。 继承自 deviceConfiguration
userStatuses deviceConfigurationUserStatus 集合 按用户排列的设备配置安装状态。 继承自 deviceConfiguration
deviceStatusOverview deviceConfigurationDeviceOverview 设备配置设备状态概述 继承自 deviceConfiguration
userStatusOverview deviceConfigurationUserOverview 设备配置用户状态概述 继承自 deviceConfiguration
deviceSettingStateSummaries settingStateDeviceSummary 集合 设备配置设置状态设备摘要 继承自 deviceConfiguration

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "@odata.type": "#microsoft.graph.macOSEndpointProtectionConfiguration",
  "id": "String (identifier)",
  "lastModifiedDateTime": "String (timestamp)",
  "roleScopeTagIds": [
    "String"
  ],
  "supportsScopeTags": true,
  "deviceManagementApplicabilityRuleOsEdition": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
    "osEditionTypes": [
      "String"
    ],
    "name": "String",
    "ruleType": "String"
  },
  "deviceManagementApplicabilityRuleOsVersion": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
    "minOSVersion": "String",
    "maxOSVersion": "String",
    "name": "String",
    "ruleType": "String"
  },
  "deviceManagementApplicabilityRuleDeviceMode": {
    "@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
    "deviceMode": "String",
    "name": "String",
    "ruleType": "String"
  },
  "createdDateTime": "String (timestamp)",
  "description": "String",
  "displayName": "String",
  "version": 1024,
  "gatekeeperAllowedAppSource": "String",
  "gatekeeperBlockOverride": true,
  "firewallEnabled": true,
  "firewallBlockAllIncoming": true,
  "firewallEnableStealthMode": true,
  "firewallApplications": [
    {
      "@odata.type": "microsoft.graph.macOSFirewallApplication",
      "bundleId": "String",
      "allowsIncomingConnections": true
    }
  ],
  "fileVaultEnabled": true,
  "fileVaultSelectedRecoveryKeyTypes": "String",
  "fileVaultInstitutionalRecoveryKeyCertificate": "binary",
  "fileVaultInstitutionalRecoveryKeyCertificateFileName": "String",
  "fileVaultPersonalRecoveryKeyHelpMessage": "String",
  "fileVaultAllowDeferralUntilSignOut": true,
  "fileVaultNumberOfTimesUserCanIgnore": 1024,
  "fileVaultDisablePromptAtSignOut": true,
  "fileVaultPersonalRecoveryKeyRotationInMonths": 1024,
  "fileVaultHidePersonalRecoveryKey": true,
  "advancedThreatProtectionRealTime": "String",
  "advancedThreatProtectionCloudDelivered": "String",
  "advancedThreatProtectionAutomaticSampleSubmission": "String",
  "advancedThreatProtectionDiagnosticDataCollection": "String",
  "advancedThreatProtectionExcludedFolders": [
    "String"
  ],
  "advancedThreatProtectionExcludedFiles": [
    "String"
  ],
  "advancedThreatProtectionExcludedExtensions": [
    "String"
  ],
  "advancedThreatProtectionExcludedProcesses": [
    "String"
  ]
}