获取 windows10GeneralConfiguration
命名空间：microsoft.graph
重要： /beta 版本下的 Microsoft Graph API 可能会更改;不支持生产使用。
注意：适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证。
读取 windows10GeneralConfiguration 对象的属性和关系。
此 API 可用于以下国家级云部署。
| 全局服务 | 美国政府 L4 | 美国政府 L5 (DOD) | 由世纪互联运营的中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
权限
要调用此 API，需要以下权限之一。 若要了解详细信息，包括如何选择权限的信息，请参阅权限。
| 权限类型 | 权限（从最低特权到最高特权） |
|---|---|
| 委派（工作或学校帐户） | DeviceManagementConfiguration.Read.All、DeviceManagementConfiguration.ReadWrite.All |
| 委派（个人 Microsoft 帐户） | 不支持。 |
| 应用程序 | DeviceManagementConfiguration.Read.All、DeviceManagementConfiguration.ReadWrite.All |
HTTP 请求
GET /deviceManagement/deviceConfigurations/{deviceConfigurationId}
GET /deviceManagement/deviceConfigurations/{deviceConfigurationId}/groupAssignments/{deviceConfigurationGroupAssignmentId}/deviceConfiguration
GET /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsDomainJoinConfiguration/networkAccessConfigurations/{deviceConfigurationId}
可选的查询参数
此方法支持 OData 查询参数 来帮助自定义响应。
请求标头
| 标头 | 值 |
|---|---|
| Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
| 接受 | application/json |
请求正文
请勿提供此方法的请求正文。
响应
如果成功，此方法在响应正文中返回 200 OK 响应代码和 windows10GeneralConfiguration 对象。
示例
请求
下面是一个请求示例。
GET https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId}
响应
下面是一个响应示例。 注意：为简洁起见，可能会截断此处显示的响应对象。 将从实际调用中返回所有属性。
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 15912
{
"value": {
"@odata.type": "#microsoft.graph.windows10GeneralConfiguration",
"id": "a4235d71-5d71-a423-715d-23a4715d23a4",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"supportsScopeTags": true,
"deviceManagementApplicabilityRuleOsEdition": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsEdition",
"osEditionTypes": [
"windows10EnterpriseN"
],
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleOsVersion": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleOsVersion",
"minOSVersion": "Min OSVersion value",
"maxOSVersion": "Max OSVersion value",
"name": "Name value",
"ruleType": "exclude"
},
"deviceManagementApplicabilityRuleDeviceMode": {
"@odata.type": "microsoft.graph.deviceManagementApplicabilityRuleDeviceMode",
"deviceMode": "sModeConfiguration",
"name": "Name value",
"ruleType": "exclude"
},
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"taskManagerBlockEndTask": true,
"energySaverOnBatteryThresholdPercentage": 7,
"energySaverPluggedInThresholdPercentage": 7,
"powerLidCloseActionOnBattery": "noAction",
"powerLidCloseActionPluggedIn": "noAction",
"powerButtonActionOnBattery": "noAction",
"powerButtonActionPluggedIn": "noAction",
"powerSleepButtonActionOnBattery": "noAction",
"powerSleepButtonActionPluggedIn": "noAction",
"powerHybridSleepOnBattery": "enabled",
"powerHybridSleepPluggedIn": "enabled",
"windows10AppsForceUpdateSchedule": {
"@odata.type": "microsoft.graph.windows10AppsForceUpdateSchedule",
"startDateTime": "2016-12-31T23:58:46.7156189-08:00",
"recurrence": "daily",
"runImmediatelyIfAfterStartDateTime": true
},
"enableAutomaticRedeployment": true,
"microsoftAccountSignInAssistantSettings": "disabled",
"authenticationAllowSecondaryDevice": true,
"authenticationWebSignIn": "enabled",
"authenticationPreferredAzureADTenantDomainName": "Authentication Preferred Azure ADTenant Domain Name value",
"cryptographyAllowFipsAlgorithmPolicy": true,
"displayAppListWithGdiDPIScalingTurnedOn": [
"Display App List With Gdi DPIScaling Turned On value"
],
"displayAppListWithGdiDPIScalingTurnedOff": [
"Display App List With Gdi DPIScaling Turned Off value"
],
"enterpriseCloudPrintDiscoveryEndPoint": "Enterprise Cloud Print Discovery End Point value",
"enterpriseCloudPrintOAuthAuthority": "Enterprise Cloud Print OAuth Authority value",
"enterpriseCloudPrintOAuthClientIdentifier": "Enterprise Cloud Print OAuth Client Identifier value",
"enterpriseCloudPrintResourceIdentifier": "Enterprise Cloud Print Resource Identifier value",
"enterpriseCloudPrintDiscoveryMaxLimit": 5,
"enterpriseCloudPrintMopriaDiscoveryResourceIdentifier": "Enterprise Cloud Print Mopria Discovery Resource Identifier value",
"experienceDoNotSyncBrowserSettings": "blockedWithUserOverride",
"messagingBlockSync": true,
"messagingBlockMMS": true,
"messagingBlockRichCommunicationServices": true,
"printerNames": [
"Printer Names value"
],
"printerDefaultName": "Printer Default Name value",
"printerBlockAddition": true,
"searchBlockDiacritics": true,
"searchDisableAutoLanguageDetection": true,
"searchDisableIndexingEncryptedItems": true,
"searchEnableRemoteQueries": true,
"searchDisableUseLocation": true,
"searchDisableLocation": true,
"searchDisableIndexerBackoff": true,
"searchDisableIndexingRemovableDrive": true,
"searchEnableAutomaticIndexSizeManangement": true,
"searchBlockWebResults": true,
"findMyFiles": "enabled",
"securityBlockAzureADJoinedDevicesAutoEncryption": true,
"diagnosticsDataSubmissionMode": "none",
"oneDriveDisableFileSync": true,
"systemTelemetryProxyServer": "System Telemetry Proxy Server value",
"edgeTelemetryForMicrosoft365Analytics": "intranet",
"inkWorkspaceAccess": "enabled",
"inkWorkspaceAccessState": "blocked",
"inkWorkspaceBlockSuggestedApps": true,
"smartScreenEnableAppInstallControl": true,
"smartScreenAppInstallControl": "anywhere",
"personalizationDesktopImageUrl": "https://example.com/personalizationDesktopImageUrl/",
"personalizationLockScreenImageUrl": "https://example.com/personalizationLockScreenImageUrl/",
"bluetoothAllowedServices": [
"Bluetooth Allowed Services value"
],
"bluetoothBlockAdvertising": true,
"bluetoothBlockPromptedProximalConnections": true,
"bluetoothBlockDiscoverableMode": true,
"bluetoothBlockPrePairing": true,
"edgeBlockAutofill": true,
"edgeBlocked": true,
"edgeCookiePolicy": "allow",
"edgeBlockDeveloperTools": true,
"edgeBlockSendingDoNotTrackHeader": true,
"edgeBlockExtensions": true,
"edgeBlockInPrivateBrowsing": true,
"edgeBlockJavaScript": true,
"edgeBlockPasswordManager": true,
"edgeBlockAddressBarDropdown": true,
"edgeBlockCompatibilityList": true,
"edgeClearBrowsingDataOnExit": true,
"edgeAllowStartPagesModification": true,
"edgeDisableFirstRunPage": true,
"edgeBlockLiveTileDataCollection": true,
"edgeSyncFavoritesWithInternetExplorer": true,
"edgeFavoritesListLocation": "Edge Favorites List Location value",
"edgeBlockEditFavorites": true,
"edgeNewTabPageURL": "Edge New Tab Page URL value",
"edgeHomeButtonConfiguration": {
"@odata.type": "microsoft.graph.edgeHomeButtonConfiguration"
},
"edgeHomeButtonConfigurationEnabled": true,
"edgeOpensWith": "startPage",
"edgeBlockSideloadingExtensions": true,
"edgeRequiredExtensionPackageFamilyNames": [
"Edge Required Extension Package Family Names value"
],
"edgeBlockPrinting": true,
"edgeFavoritesBarVisibility": "hide",
"edgeBlockSavingHistory": true,
"edgeBlockFullScreenMode": true,
"edgeBlockWebContentOnNewTabPage": true,
"edgeBlockTabPreloading": true,
"edgeBlockPrelaunch": true,
"edgeShowMessageWhenOpeningInternetExplorerSites": "disabled",
"edgePreventCertificateErrorOverride": true,
"edgeKioskModeRestriction": "digitalSignage",
"edgeKioskResetAfterIdleTimeInMinutes": 4,
"cellularBlockDataWhenRoaming": true,
"cellularBlockVpn": true,
"cellularBlockVpnWhenRoaming": true,
"cellularData": "required",
"defenderRequireRealTimeMonitoring": true,
"defenderRequireBehaviorMonitoring": true,
"defenderRequireNetworkInspectionSystem": true,
"defenderScanDownloads": true,
"defenderScheduleScanEnableLowCpuPriority": true,
"defenderDisableCatchupQuickScan": true,
"defenderDisableCatchupFullScan": true,
"defenderScanScriptsLoadedInInternetExplorer": true,
"defenderBlockEndUserAccess": true,
"defenderSignatureUpdateIntervalInHours": 6,
"defenderMonitorFileActivity": "disable",
"defenderDaysBeforeDeletingQuarantinedMalware": 12,
"defenderScanMaxCpu": 2,
"defenderScanArchiveFiles": true,
"defenderScanIncomingMail": true,
"defenderScanRemovableDrivesDuringFullScan": true,
"defenderScanMappedNetworkDrivesDuringFullScan": true,
"defenderScanNetworkFiles": true,
"defenderRequireCloudProtection": true,
"defenderCloudBlockLevel": "high",
"defenderCloudExtendedTimeout": 12,
"defenderCloudExtendedTimeoutInSeconds": 5,
"defenderPromptForSampleSubmission": "alwaysPrompt",
"defenderScheduledQuickScanTime": "11:58:49.3840000",
"defenderScanType": "disabled",
"defenderSystemScanSchedule": "everyday",
"defenderScheduledScanTime": "11:59:10.9990000",
"defenderPotentiallyUnwantedAppAction": "block",
"defenderPotentiallyUnwantedAppActionSetting": "enable",
"defenderSubmitSamplesConsentType": "alwaysPrompt",
"defenderBlockOnAccessProtection": true,
"defenderDetectedMalwareActions": {
"@odata.type": "microsoft.graph.defenderDetectedMalwareActions",
"lowSeverity": "clean",
"moderateSeverity": "clean",
"highSeverity": "clean",
"severeSeverity": "clean"
},
"defenderFileExtensionsToExclude": [
"Defender File Extensions To Exclude value"
],
"defenderFilesAndFoldersToExclude": [
"Defender Files And Folders To Exclude value"
],
"defenderProcessesToExclude": [
"Defender Processes To Exclude value"
],
"lockScreenAllowTimeoutConfiguration": true,
"lockScreenBlockActionCenterNotifications": true,
"lockScreenBlockCortana": true,
"lockScreenBlockToastNotifications": true,
"lockScreenTimeoutInSeconds": 10,
"lockScreenActivateAppsWithVoice": "enabled",
"passwordBlockSimple": true,
"passwordExpirationDays": 6,
"passwordMinimumLength": 5,
"passwordMinutesOfInactivityBeforeScreenTimeout": 14,
"passwordMinimumCharacterSetCount": 0,
"passwordPreviousPasswordBlockCount": 2,
"passwordRequired": true,
"passwordRequireWhenResumeFromIdleState": true,
"passwordRequiredType": "alphanumeric",
"passwordSignInFailureCountBeforeFactoryReset": 12,
"passwordMinimumAgeInDays": 8,
"privacyAdvertisingId": "blocked",
"privacyAutoAcceptPairingAndConsentPrompts": true,
"privacyDisableLaunchExperience": true,
"privacyBlockInputPersonalization": true,
"privacyBlockPublishUserActivities": true,
"privacyBlockActivityFeed": true,
"activateAppsWithVoice": "enabled",
"startBlockUnpinningAppsFromTaskbar": true,
"startMenuAppListVisibility": "collapse",
"startMenuHideChangeAccountSettings": true,
"startMenuHideFrequentlyUsedApps": true,
"startMenuHideHibernate": true,
"startMenuHideLock": true,
"startMenuHidePowerButton": true,
"startMenuHideRecentJumpLists": true,
"startMenuHideRecentlyAddedApps": true,
"startMenuHideRestartOptions": true,
"startMenuHideShutDown": true,
"startMenuHideSignOut": true,
"startMenuHideSleep": true,
"startMenuHideSwitchAccount": true,
"startMenuHideUserTile": true,
"startMenuLayoutEdgeAssetsXml": "c3RhcnRNZW51TGF5b3V0RWRnZUFzc2V0c1htbA==",
"startMenuLayoutXml": "c3RhcnRNZW51TGF5b3V0WG1s",
"startMenuMode": "fullScreen",
"startMenuPinnedFolderDocuments": "hide",
"startMenuPinnedFolderDownloads": "hide",
"startMenuPinnedFolderFileExplorer": "hide",
"startMenuPinnedFolderHomeGroup": "hide",
"startMenuPinnedFolderMusic": "hide",
"startMenuPinnedFolderNetwork": "hide",
"startMenuPinnedFolderPersonalFolder": "hide",
"startMenuPinnedFolderPictures": "hide",
"startMenuPinnedFolderSettings": "hide",
"startMenuPinnedFolderVideos": "hide",
"settingsBlockSettingsApp": true,
"settingsBlockSystemPage": true,
"settingsBlockDevicesPage": true,
"settingsBlockNetworkInternetPage": true,
"settingsBlockPersonalizationPage": true,
"settingsBlockAccountsPage": true,
"settingsBlockTimeLanguagePage": true,
"settingsBlockEaseOfAccessPage": true,
"settingsBlockPrivacyPage": true,
"settingsBlockUpdateSecurityPage": true,
"settingsBlockAppsPage": true,
"settingsBlockGamingPage": true,
"windowsSpotlightBlockConsumerSpecificFeatures": true,
"windowsSpotlightBlocked": true,
"windowsSpotlightBlockOnActionCenter": true,
"windowsSpotlightBlockTailoredExperiences": true,
"windowsSpotlightBlockThirdPartyNotifications": true,
"windowsSpotlightBlockWelcomeExperience": true,
"windowsSpotlightBlockWindowsTips": true,
"windowsSpotlightConfigureOnLockScreen": "disabled",
"networkProxyApplySettingsDeviceWide": true,
"networkProxyDisableAutoDetect": true,
"networkProxyAutomaticConfigurationUrl": "https://example.com/networkProxyAutomaticConfigurationUrl/",
"networkProxyServer": {
"@odata.type": "microsoft.graph.windows10NetworkProxyServer",
"address": "Address value",
"exceptions": [
"Exceptions value"
],
"useForLocalAddresses": true
},
"accountsBlockAddingNonMicrosoftAccountEmail": true,
"antiTheftModeBlocked": true,
"bluetoothBlocked": true,
"cameraBlocked": true,
"connectedDevicesServiceBlocked": true,
"certificatesBlockManualRootCertificateInstallation": true,
"copyPasteBlocked": true,
"cortanaBlocked": true,
"deviceManagementBlockFactoryResetOnMobile": true,
"deviceManagementBlockManualUnenroll": true,
"safeSearchFilter": "strict",
"edgeBlockPopups": true,
"edgeBlockSearchSuggestions": true,
"edgeBlockSearchEngineCustomization": true,
"edgeBlockSendingIntranetTrafficToInternetExplorer": true,
"edgeSendIntranetTrafficToInternetExplorer": true,
"edgeRequireSmartScreen": true,
"edgeEnterpriseModeSiteListLocation": "Edge Enterprise Mode Site List Location value",
"edgeFirstRunUrl": "https://example.com/edgeFirstRunUrl/",
"edgeSearchEngine": {
"@odata.type": "microsoft.graph.edgeSearchEngineBase"
},
"edgeHomepageUrls": [
"Edge Homepage Urls value"
],
"edgeBlockAccessToAboutFlags": true,
"smartScreenBlockPromptOverride": true,
"smartScreenBlockPromptOverrideForFiles": true,
"webRtcBlockLocalhostIpAddress": true,
"internetSharingBlocked": true,
"settingsBlockAddProvisioningPackage": true,
"settingsBlockRemoveProvisioningPackage": true,
"settingsBlockChangeSystemTime": true,
"settingsBlockEditDeviceName": true,
"settingsBlockChangeRegion": true,
"settingsBlockChangeLanguage": true,
"settingsBlockChangePowerSleep": true,
"locationServicesBlocked": true,
"microsoftAccountBlocked": true,
"microsoftAccountBlockSettingsSync": true,
"nfcBlocked": true,
"resetProtectionModeBlocked": true,
"screenCaptureBlocked": true,
"storageBlockRemovableStorage": true,
"storageRequireMobileDeviceEncryption": true,
"usbBlocked": true,
"voiceRecordingBlocked": true,
"wiFiBlockAutomaticConnectHotspots": true,
"wiFiBlocked": true,
"wiFiBlockManualConfiguration": true,
"wiFiScanInterval": 0,
"wirelessDisplayBlockProjectionToThisDevice": true,
"wirelessDisplayBlockUserInputFromReceiver": true,
"wirelessDisplayRequirePinForPairing": true,
"windowsStoreBlocked": true,
"appsAllowTrustedAppsSideloading": "blocked",
"windowsStoreBlockAutoUpdate": true,
"developerUnlockSetting": "blocked",
"sharedUserAppDataAllowed": true,
"appsBlockWindowsStoreOriginatedApps": true,
"windowsStoreEnablePrivateStoreOnly": true,
"storageRestrictAppDataToSystemVolume": true,
"storageRestrictAppInstallToSystemVolume": true,
"gameDvrBlocked": true,
"experienceBlockDeviceDiscovery": true,
"experienceBlockErrorDialogWhenNoSIM": true,
"experienceBlockTaskSwitcher": true,
"logonBlockFastUserSwitching": true,
"tenantLockdownRequireNetworkDuringOutOfBoxExperience": true,
"appManagementMSIAllowUserControlOverInstall": true,
"appManagementMSIAlwaysInstallWithElevatedPrivileges": true,
"dataProtectionBlockDirectMemoryAccess": true,
"appManagementPackageFamilyNamesToLaunchAfterLogOn": [
"App Management Package Family Names To Launch After Log On value"
],
"uninstallBuiltInApps": true,
"configureTimeZone": "Configure Time Zone value"
}
}
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈