< Back
New-DeviceManagementObject
Post
NAME New-DeviceManagementObject
SYNOPSIS
Creates a new object which represents a "microsoft.graph.deviceManagement" (or one of its derived types).
SYNTAX
New-DeviceManagementObject [-applePushNotificationCertificate <object>] [-conditionalAccessSettings <object>]
[-detectedApps <object[]>] [-deviceCategories <object[]>] [-deviceCompliancePolicies <object[]>]
[-deviceCompliancePolicyDeviceStateSummary <object>] [-deviceCompliancePolicySettingStateSummaries <object[]>]
[-deviceConfigurationDeviceStateSummaries <object>] [-deviceConfigurations <object[]>]
[-deviceEnrollmentConfigurations <object[]>] [-deviceManagementPartners <object[]>] [-exchangeConnectors
<object[]>] [-intuneBrand <object>] [-iosUpdateStatuses <object[]>] [-managedDeviceOverview <object>]
[-managedDevices <object[]>] [-mobileThreatDefenseConnectors <object[]>] [-notificationMessageTemplates
<object[]>] [-remoteAssistancePartners <object[]>] [-resourceOperations <object[]>] [-roleAssignments <object[]>]
[-roleDefinitions <object[]>] [-settings <object>] [-softwareUpdateStatusSummary <object>] [-subscriptionState
<string>] [-telecomExpenseManagementPartners <object[]>] [-termsAndConditions <object[]>] [-troubleshootingEvents
<object[]>] [-windowsInformationProtectionAppLearningSummaries <object[]>]
[-windowsInformationProtectionNetworkLearningSummaries <object[]>] [<CommonParameters>]
DESCRIPTION
Creates a new object which represents a "microsoft.graph.deviceManagement" (or one of its derived types).
Singleton entity that acts as a container for all device management functionality.
PARAMETERS
-subscriptionState <string>
The "subscriptionState" property, of type "microsoft.graph.deviceManagementSubscriptionState".
This property is on the "microsoft.graph.deviceManagement" type.
Tenant mobile device management subscription state.
Valid values: 'pending', 'active', 'warning', 'disabled', 'deleted', 'blocked', 'lockedOut'
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-settings <object>
The "settings" property, of type "microsoft.graph.deviceManagementSettings".
This property is on the "microsoft.graph.deviceManagement" type.
Account level settings.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-intuneBrand <object>
The "intuneBrand" property, of type "microsoft.graph.intuneBrand".
This property is on the "microsoft.graph.deviceManagement" type.
intuneBrand contains data which is used in customizing the appearance of the Company Portal applications as
well as the end user web portal.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-termsAndConditions <object[]>
The "termsAndConditions" property, of type "microsoft.graph.termsAndConditions".
This property is on the "microsoft.graph.deviceManagement" type.
The terms and conditions associated with device management of the company.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-applePushNotificationCertificate <object>
The "applePushNotificationCertificate" property, of type "microsoft.graph.applePushNotificationCertificate".
This property is on the "microsoft.graph.deviceManagement" type.
Apple push notification certificate.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-managedDeviceOverview <object>
The "managedDeviceOverview" property, of type "microsoft.graph.managedDeviceOverview".
This property is on the "microsoft.graph.deviceManagement" type.
Device overview
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-detectedApps <object[]>
The "detectedApps" property, of type "microsoft.graph.detectedApp".
This property is on the "microsoft.graph.deviceManagement" type.
The list of detected apps associated with a device.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-managedDevices <object[]>
The "managedDevices" property, of type "microsoft.graph.managedDevice".
This property is on the "microsoft.graph.deviceManagement" type.
The list of managed devices.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-deviceConfigurations <object[]>
The "deviceConfigurations" property, of type "microsoft.graph.deviceConfiguration".
This property is on the "microsoft.graph.deviceManagement" type.
The device configurations.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-deviceCompliancePolicies <object[]>
The "deviceCompliancePolicies" property, of type "microsoft.graph.deviceCompliancePolicy".
This property is on the "microsoft.graph.deviceManagement" type.
The device compliance policies.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-softwareUpdateStatusSummary <object>
The "softwareUpdateStatusSummary" property, of type "microsoft.graph.softwareUpdateStatusSummary".
This property is on the "microsoft.graph.deviceManagement" type.
The software update status summary.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-deviceCompliancePolicyDeviceStateSummary <object>
The "deviceCompliancePolicyDeviceStateSummary" property, of type
"microsoft.graph.deviceCompliancePolicyDeviceStateSummary".
This property is on the "microsoft.graph.deviceManagement" type.
The device compliance state summary for this account.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-deviceCompliancePolicySettingStateSummaries <object[]>
The "deviceCompliancePolicySettingStateSummaries" property, of type
"microsoft.graph.deviceCompliancePolicySettingStateSummary".
This property is on the "microsoft.graph.deviceManagement" type.
The summary states of compliance policy settings for this account.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-deviceConfigurationDeviceStateSummaries <object>
The "deviceConfigurationDeviceStateSummaries" property, of type
"microsoft.graph.deviceConfigurationDeviceStateSummary".
This property is on the "microsoft.graph.deviceManagement" type.
The device configuration device state summary for this account.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-iosUpdateStatuses <object[]>
The "iosUpdateStatuses" property, of type "microsoft.graph.iosUpdateDeviceStatus".
This property is on the "microsoft.graph.deviceManagement" type.
The IOS software update installation statuses for this account.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-deviceCategories <object[]>
The "deviceCategories" property, of type "microsoft.graph.deviceCategory".
This property is on the "microsoft.graph.deviceManagement" type.
The list of device categories with the tenant.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-exchangeConnectors <object[]>
The "exchangeConnectors" property, of type "microsoft.graph.deviceManagementExchangeConnector".
This property is on the "microsoft.graph.deviceManagement" type.
The list of Exchange Connectors configured by the tenant.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-deviceEnrollmentConfigurations <object[]>
The "deviceEnrollmentConfigurations" property, of type "microsoft.graph.deviceEnrollmentConfiguration".
This property is on the "microsoft.graph.deviceManagement" type.
The list of device enrollment configurations
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-conditionalAccessSettings <object>
The "conditionalAccessSettings" property, of type "microsoft.graph.onPremisesConditionalAccessSettings".
This property is on the "microsoft.graph.deviceManagement" type.
The Exchange on premises conditional access settings. On premises conditional access will require devices to
be both enrolled and compliant for mail access
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-mobileThreatDefenseConnectors <object[]>
The "mobileThreatDefenseConnectors" property, of type "microsoft.graph.mobileThreatDefenseConnector".
This property is on the "microsoft.graph.deviceManagement" type.
The list of Mobile threat Defense connectors configured by the tenant.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-deviceManagementPartners <object[]>
The "deviceManagementPartners" property, of type "microsoft.graph.deviceManagementPartner".
This property is on the "microsoft.graph.deviceManagement" type.
The list of Device Management Partners configured by the tenant.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-notificationMessageTemplates <object[]>
The "notificationMessageTemplates" property, of type "microsoft.graph.notificationMessageTemplate".
This property is on the "microsoft.graph.deviceManagement" type.
The Notification Message Templates.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-roleDefinitions <object[]>
The "roleDefinitions" property, of type "microsoft.graph.roleDefinition".
This property is on the "microsoft.graph.deviceManagement" type.
The Role Definitions.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-roleAssignments <object[]>
The "roleAssignments" property, of type "microsoft.graph.deviceAndAppManagementRoleAssignment".
This property is on the "microsoft.graph.deviceManagement" type.
The Role Assignments.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-resourceOperations <object[]>
The "resourceOperations" property, of type "microsoft.graph.resourceOperation".
This property is on the "microsoft.graph.deviceManagement" type.
The Resource Operations.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-telecomExpenseManagementPartners <object[]>
The "telecomExpenseManagementPartners" property, of type "microsoft.graph.telecomExpenseManagementPartner".
This property is on the "microsoft.graph.deviceManagement" type.
The telecom expense management partners.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-remoteAssistancePartners <object[]>
The "remoteAssistancePartners" property, of type "microsoft.graph.remoteAssistancePartner".
This property is on the "microsoft.graph.deviceManagement" type.
The remote assist partners.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-windowsInformationProtectionAppLearningSummaries <object[]>
The "windowsInformationProtectionAppLearningSummaries" property, of type
"microsoft.graph.windowsInformationProtectionAppLearningSummary".
This property is on the "microsoft.graph.deviceManagement" type.
The windows information protection app learning summaries.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-windowsInformationProtectionNetworkLearningSummaries <object[]>
The "windowsInformationProtectionNetworkLearningSummaries" property, of type
"microsoft.graph.windowsInformationProtectionNetworkLearningSummary".
This property is on the "microsoft.graph.deviceManagement" type.
The windows information protection network learning summaries.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-troubleshootingEvents <object[]>
The "troubleshootingEvents" property, of type "microsoft.graph.deviceManagementTroubleshootingEvent".
This property is on the "microsoft.graph.deviceManagement" type.
The list of troubleshooting events for the tenant.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
RELATED LINKS
SYNOPSIS
Creates a new object which represents a "microsoft.graph.deviceManagement" (or one of its derived types).
SYNTAX
New-DeviceManagementObject [-applePushNotificationCertificate <object>] [-conditionalAccessSettings <object>]
[-detectedApps <object[]>] [-deviceCategories <object[]>] [-deviceCompliancePolicies <object[]>]
[-deviceCompliancePolicyDeviceStateSummary <object>] [-deviceCompliancePolicySettingStateSummaries <object[]>]
[-deviceConfigurationDeviceStateSummaries <object>] [-deviceConfigurations <object[]>]
[-deviceEnrollmentConfigurations <object[]>] [-deviceManagementPartners <object[]>] [-exchangeConnectors
<object[]>] [-intuneBrand <object>] [-iosUpdateStatuses <object[]>] [-managedDeviceOverview <object>]
[-managedDevices <object[]>] [-mobileThreatDefenseConnectors <object[]>] [-notificationMessageTemplates
<object[]>] [-remoteAssistancePartners <object[]>] [-resourceOperations <object[]>] [-roleAssignments <object[]>]
[-roleDefinitions <object[]>] [-settings <object>] [-softwareUpdateStatusSummary <object>] [-subscriptionState
<string>] [-telecomExpenseManagementPartners <object[]>] [-termsAndConditions <object[]>] [-troubleshootingEvents
<object[]>] [-windowsInformationProtectionAppLearningSummaries <object[]>]
[-windowsInformationProtectionNetworkLearningSummaries <object[]>] [<CommonParameters>]
DESCRIPTION
Creates a new object which represents a "microsoft.graph.deviceManagement" (or one of its derived types).
Singleton entity that acts as a container for all device management functionality.
PARAMETERS
-subscriptionState <string>
The "subscriptionState" property, of type "microsoft.graph.deviceManagementSubscriptionState".
This property is on the "microsoft.graph.deviceManagement" type.
Tenant mobile device management subscription state.
Valid values: 'pending', 'active', 'warning', 'disabled', 'deleted', 'blocked', 'lockedOut'
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-settings <object>
The "settings" property, of type "microsoft.graph.deviceManagementSettings".
This property is on the "microsoft.graph.deviceManagement" type.
Account level settings.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-intuneBrand <object>
The "intuneBrand" property, of type "microsoft.graph.intuneBrand".
This property is on the "microsoft.graph.deviceManagement" type.
intuneBrand contains data which is used in customizing the appearance of the Company Portal applications as
well as the end user web portal.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-termsAndConditions <object[]>
The "termsAndConditions" property, of type "microsoft.graph.termsAndConditions".
This property is on the "microsoft.graph.deviceManagement" type.
The terms and conditions associated with device management of the company.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-applePushNotificationCertificate <object>
The "applePushNotificationCertificate" property, of type "microsoft.graph.applePushNotificationCertificate".
This property is on the "microsoft.graph.deviceManagement" type.
Apple push notification certificate.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-managedDeviceOverview <object>
The "managedDeviceOverview" property, of type "microsoft.graph.managedDeviceOverview".
This property is on the "microsoft.graph.deviceManagement" type.
Device overview
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-detectedApps <object[]>
The "detectedApps" property, of type "microsoft.graph.detectedApp".
This property is on the "microsoft.graph.deviceManagement" type.
The list of detected apps associated with a device.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-managedDevices <object[]>
The "managedDevices" property, of type "microsoft.graph.managedDevice".
This property is on the "microsoft.graph.deviceManagement" type.
The list of managed devices.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-deviceConfigurations <object[]>
The "deviceConfigurations" property, of type "microsoft.graph.deviceConfiguration".
This property is on the "microsoft.graph.deviceManagement" type.
The device configurations.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-deviceCompliancePolicies <object[]>
The "deviceCompliancePolicies" property, of type "microsoft.graph.deviceCompliancePolicy".
This property is on the "microsoft.graph.deviceManagement" type.
The device compliance policies.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-softwareUpdateStatusSummary <object>
The "softwareUpdateStatusSummary" property, of type "microsoft.graph.softwareUpdateStatusSummary".
This property is on the "microsoft.graph.deviceManagement" type.
The software update status summary.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-deviceCompliancePolicyDeviceStateSummary <object>
The "deviceCompliancePolicyDeviceStateSummary" property, of type
"microsoft.graph.deviceCompliancePolicyDeviceStateSummary".
This property is on the "microsoft.graph.deviceManagement" type.
The device compliance state summary for this account.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-deviceCompliancePolicySettingStateSummaries <object[]>
The "deviceCompliancePolicySettingStateSummaries" property, of type
"microsoft.graph.deviceCompliancePolicySettingStateSummary".
This property is on the "microsoft.graph.deviceManagement" type.
The summary states of compliance policy settings for this account.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-deviceConfigurationDeviceStateSummaries <object>
The "deviceConfigurationDeviceStateSummaries" property, of type
"microsoft.graph.deviceConfigurationDeviceStateSummary".
This property is on the "microsoft.graph.deviceManagement" type.
The device configuration device state summary for this account.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-iosUpdateStatuses <object[]>
The "iosUpdateStatuses" property, of type "microsoft.graph.iosUpdateDeviceStatus".
This property is on the "microsoft.graph.deviceManagement" type.
The IOS software update installation statuses for this account.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-deviceCategories <object[]>
The "deviceCategories" property, of type "microsoft.graph.deviceCategory".
This property is on the "microsoft.graph.deviceManagement" type.
The list of device categories with the tenant.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-exchangeConnectors <object[]>
The "exchangeConnectors" property, of type "microsoft.graph.deviceManagementExchangeConnector".
This property is on the "microsoft.graph.deviceManagement" type.
The list of Exchange Connectors configured by the tenant.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-deviceEnrollmentConfigurations <object[]>
The "deviceEnrollmentConfigurations" property, of type "microsoft.graph.deviceEnrollmentConfiguration".
This property is on the "microsoft.graph.deviceManagement" type.
The list of device enrollment configurations
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-conditionalAccessSettings <object>
The "conditionalAccessSettings" property, of type "microsoft.graph.onPremisesConditionalAccessSettings".
This property is on the "microsoft.graph.deviceManagement" type.
The Exchange on premises conditional access settings. On premises conditional access will require devices to
be both enrolled and compliant for mail access
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-mobileThreatDefenseConnectors <object[]>
The "mobileThreatDefenseConnectors" property, of type "microsoft.graph.mobileThreatDefenseConnector".
This property is on the "microsoft.graph.deviceManagement" type.
The list of Mobile threat Defense connectors configured by the tenant.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-deviceManagementPartners <object[]>
The "deviceManagementPartners" property, of type "microsoft.graph.deviceManagementPartner".
This property is on the "microsoft.graph.deviceManagement" type.
The list of Device Management Partners configured by the tenant.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-notificationMessageTemplates <object[]>
The "notificationMessageTemplates" property, of type "microsoft.graph.notificationMessageTemplate".
This property is on the "microsoft.graph.deviceManagement" type.
The Notification Message Templates.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-roleDefinitions <object[]>
The "roleDefinitions" property, of type "microsoft.graph.roleDefinition".
This property is on the "microsoft.graph.deviceManagement" type.
The Role Definitions.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-roleAssignments <object[]>
The "roleAssignments" property, of type "microsoft.graph.deviceAndAppManagementRoleAssignment".
This property is on the "microsoft.graph.deviceManagement" type.
The Role Assignments.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-resourceOperations <object[]>
The "resourceOperations" property, of type "microsoft.graph.resourceOperation".
This property is on the "microsoft.graph.deviceManagement" type.
The Resource Operations.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-telecomExpenseManagementPartners <object[]>
The "telecomExpenseManagementPartners" property, of type "microsoft.graph.telecomExpenseManagementPartner".
This property is on the "microsoft.graph.deviceManagement" type.
The telecom expense management partners.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-remoteAssistancePartners <object[]>
The "remoteAssistancePartners" property, of type "microsoft.graph.remoteAssistancePartner".
This property is on the "microsoft.graph.deviceManagement" type.
The remote assist partners.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-windowsInformationProtectionAppLearningSummaries <object[]>
The "windowsInformationProtectionAppLearningSummaries" property, of type
"microsoft.graph.windowsInformationProtectionAppLearningSummary".
This property is on the "microsoft.graph.deviceManagement" type.
The windows information protection app learning summaries.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-windowsInformationProtectionNetworkLearningSummaries <object[]>
The "windowsInformationProtectionNetworkLearningSummaries" property, of type
"microsoft.graph.windowsInformationProtectionNetworkLearningSummary".
This property is on the "microsoft.graph.deviceManagement" type.
The windows information protection network learning summaries.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-troubleshootingEvents <object[]>
The "troubleshootingEvents" property, of type "microsoft.graph.deviceManagementTroubleshootingEvent".
This property is on the "microsoft.graph.deviceManagement" type.
The list of troubleshooting events for the tenant.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
RELATED LINKS