Share via

New-MgBetaDeviceManagementCompliancePolicy

  • Reference
Module:
Microsoft.Graph.Beta.DeviceManagement

Create new navigation property to compliancePolicies for deviceManagement

Syntax

New-MgBetaDeviceManagementCompliancePolicy
   [-ResponseHeadersVariable <String>]
   [-AdditionalProperties <Hashtable>]
   [-Assignments <IMicrosoftGraphDeviceManagementConfigurationPolicyAssignment[]>]
   [-CreationSource <String>]
   [-Description <String>]
   [-Id <String>]
   [-Name <String>]
   [-Platforms <DeviceManagementConfigurationPlatforms>]
   [-RoleScopeTagIds <String[]>]
   [-ScheduledActionsForRule <IMicrosoftGraphDeviceManagementComplianceScheduledActionForRule[]>]
   [-Settings <IMicrosoftGraphDeviceManagementConfigurationSetting[]>]
   [-Technologies <DeviceManagementConfigurationTechnologies>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-MgBetaDeviceManagementCompliancePolicy
   -BodyParameter <IMicrosoftGraphDeviceManagementCompliancePolicy>
   [-ResponseHeadersVariable <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Create new navigation property to compliancePolicies for deviceManagement

Parameters

-AdditionalProperties

Additional Parameters

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Assignments

Policy assignments To construct, see NOTES section for ASSIGNMENTS properties and create a hash table.

Type:IMicrosoftGraphDeviceManagementConfigurationPolicyAssignment[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BodyParameter

Device Management Compliance Policy To construct, see NOTES section for BODYPARAMETER properties and create a hash table.

Type:IMicrosoftGraphDeviceManagementCompliancePolicy
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CreationSource

Policy creation source

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Policy description

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Headers

Optional headers that will be added to the request.

Type:IDictionary
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Id

The unique identifier for an entity. Read-only.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Policy name

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Platforms

Supported platform types.

Type:DeviceManagementConfigurationPlatforms
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProgressAction

{{ Fill ProgressAction Description }}

Type:ActionPreference
Aliases:proga
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResponseHeadersVariable

Optional Response Headers Variable.

Type:String
Aliases:RHV
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RoleScopeTagIds

List of Scope Tags for this Entity instance.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScheduledActionsForRule

The list of scheduled action for this rule To construct, see NOTES section for SCHEDULEDACTIONSFORRULE properties and create a hash table.

Type:IMicrosoftGraphDeviceManagementComplianceScheduledActionForRule[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Settings

Policy settings To construct, see NOTES section for SETTINGS properties and create a hash table.

Type:IMicrosoftGraphDeviceManagementConfigurationSetting[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Technologies

Describes which technology this setting can be deployed with

Type:DeviceManagementConfigurationTechnologies
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphDeviceManagementCompliancePolicy

System.Collections.IDictionary

Outputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphDeviceManagementCompliancePolicy

Notes

COMPLEX PARAMETER PROPERTIES

To create the parameters described below, construct a hash table containing the appropriate properties. For information on hash tables, run Get-Help about_Hash_Tables.

ASSIGNMENTS <IMicrosoftGraphDeviceManagementConfigurationPolicyAssignment- []>: Policy assignments

  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [Source <DeviceAndAppManagementAssignmentSource?>]: Represents source of assignment.
  • [SourceId <String>]: The identifier of the source of the assignment.
  • [Target <IMicrosoftGraphDeviceAndAppManagementAssignmentTarget>]: Base type for assignment targets.
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [DeviceAndAppManagementAssignmentFilterId <String>]: The Id of the filter for the target assignment.
    • [DeviceAndAppManagementAssignmentFilterType <DeviceAndAppManagementAssignmentFilterType?>]: Represents type of the assignment filter.

BODYPARAMETER <IMicrosoftGraphDeviceManagementCompliancePolicy>: Device Management Compliance Policy

  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [Assignments <IMicrosoftGraphDeviceManagementConfigurationPolicyAssignment- []>]: Policy assignments
    • [Id <String>]: The unique identifier for an entity. Read-only.
    • [Source <DeviceAndAppManagementAssignmentSource?>]: Represents source of assignment.
    • [SourceId <String>]: The identifier of the source of the assignment.
    • [Target <IMicrosoftGraphDeviceAndAppManagementAssignmentTarget>]: Base type for assignment targets.
      • [(Any) <Object>]: This indicates any property can be added to this object.
      • [DeviceAndAppManagementAssignmentFilterId <String>]: The Id of the filter for the target assignment.
      • [DeviceAndAppManagementAssignmentFilterType <DeviceAndAppManagementAssignmentFilterType?>]: Represents type of the assignment filter.
  • [CreationSource <String>]: Policy creation source
  • [Description <String>]: Policy description
  • [Name <String>]: Policy name
  • [Platforms <DeviceManagementConfigurationPlatforms?>]: Supported platform types.
  • [RoleScopeTagIds <String- []>]: List of Scope Tags for this Entity instance.
  • [ScheduledActionsForRule <IMicrosoftGraphDeviceManagementComplianceScheduledActionForRule- []>]: The list of scheduled action for this rule
    • [Id <String>]: The unique identifier for an entity. Read-only.
    • [RuleName <String>]: Name of the rule which this scheduled action applies to.
    • [ScheduledActionConfigurations <IMicrosoftGraphDeviceManagementComplianceActionItem- []>]: The list of scheduled action configurations for this compliance policy. This collection can contain a maximum of 100 elements.
      • [Id <String>]: The unique identifier for an entity. Read-only.
      • [ActionType <DeviceManagementComplianceActionType?>]: Scheduled Action Type Enum
      • [GracePeriodHours <Int32?>]: Number of hours to wait till the action will be enforced. Valid values 0 to 8760
      • [NotificationMessageCcList <String- []>]: A list of group IDs to speicify who to CC this notification message to. This collection can contain a maximum of 100 elements.
      • [NotificationTemplateId <String>]: What notification Message template to use
  • [Settings <IMicrosoftGraphDeviceManagementConfigurationSetting- []>]: Policy settings
    • [Id <String>]: The unique identifier for an entity. Read-only.
    • [SettingDefinitions <IMicrosoftGraphDeviceManagementConfigurationSettingDefinition- []>]: List of related Setting Definitions. This property is read-only.
      • [Id <String>]: The unique identifier for an entity. Read-only.
      • [AccessTypes <String>]: deviceManagementConfigurationSettingAccessTypes
      • [Applicability <IMicrosoftGraphDeviceManagementConfigurationSettingApplicability>]: deviceManagementConfigurationSettingApplicability
        • [(Any) <Object>]: This indicates any property can be added to this object.
        • [Description <String>]: description of the setting
        • [DeviceMode <DeviceManagementConfigurationDeviceMode?>]: Describes applicability for the mode the device is in
        • [Platform <DeviceManagementConfigurationPlatforms?>]: Supported platform types.
        • [Technologies <DeviceManagementConfigurationTechnologies?>]: Describes which technology this setting can be deployed with
      • [BaseUri <String>]: Base CSP Path
      • [CategoryId <String>]: Specifies the area group under which the setting is configured in a specified configuration service provider (CSP)
      • [Description <String>]: Description of the item
      • [DisplayName <String>]: Display name of the item
      • [HelpText <String>]: Help text of the item
      • [InfoUrls <String- []>]: List of links more info for the setting can be found at
      • [Keywords <String- []>]: Tokens which to search settings on
      • [Name <String>]: Name of the item
      • [Occurrence <IMicrosoftGraphDeviceManagementConfigurationSettingOccurrence>]: deviceManagementConfigurationSettingOccurrence
        • [(Any) <Object>]: This indicates any property can be added to this object.
        • [MaxDeviceOccurrence <Int32?>]: Maximum times setting can be set on device.
        • [MinDeviceOccurrence <Int32?>]: Minimum times setting can be set on device. A MinDeviceOccurrence of 0 means setting is optional
      • [OffsetUri <String>]: Offset CSP Path from Base
      • [ReferredSettingInformationList <IMicrosoftGraphDeviceManagementConfigurationReferredSettingInformation- []>]: List of referred setting information.
        • [SettingDefinitionId <String>]: Setting definition id that is being referred to a setting. Applicable for reusable setting.
      • [RootDefinitionId <String>]: Root setting definition if the setting is a child setting.
      • [SettingUsage <DeviceManagementConfigurationSettingUsage?>]: Supported setting types
      • [UxBehavior <DeviceManagementConfigurationControlType?>]: Setting control type representation in the UX
      • [Version <String>]: Item Version
      • [Visibility <DeviceManagementConfigurationSettingVisibility?>]: Supported setting types
    • [SettingInstance <IMicrosoftGraphDeviceManagementConfigurationSettingInstance>]: Setting instance within policy
      • [(Any) <Object>]: This indicates any property can be added to this object.
      • [SettingDefinitionId <String>]: Setting Definition Id
      • [SettingInstanceTemplateReference <IMicrosoftGraphDeviceManagementConfigurationSettingInstanceTemplateReference>]: Setting instance template reference information
        • [(Any) <Object>]: This indicates any property can be added to this object.
        • [SettingInstanceTemplateId <String>]: Setting instance template id
  • [Technologies <DeviceManagementConfigurationTechnologies?>]: Describes which technology this setting can be deployed with

SCHEDULEDACTIONSFORRULE <IMicrosoftGraphDeviceManagementComplianceScheduledActionForRule- []>: The list of scheduled action for this rule

  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [RuleName <String>]: Name of the rule which this scheduled action applies to.
  • [ScheduledActionConfigurations <IMicrosoftGraphDeviceManagementComplianceActionItem- []>]: The list of scheduled action configurations for this compliance policy. This collection can contain a maximum of 100 elements.
    • [Id <String>]: The unique identifier for an entity. Read-only.
    • [ActionType <DeviceManagementComplianceActionType?>]: Scheduled Action Type Enum
    • [GracePeriodHours <Int32?>]: Number of hours to wait till the action will be enforced. Valid values 0 to 8760
    • [NotificationMessageCcList <String- []>]: A list of group IDs to speicify who to CC this notification message to. This collection can contain a maximum of 100 elements.
    • [NotificationTemplateId <String>]: What notification Message template to use

SETTINGS <IMicrosoftGraphDeviceManagementConfigurationSetting- []>: Policy settings

  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [SettingDefinitions <IMicrosoftGraphDeviceManagementConfigurationSettingDefinition- []>]: List of related Setting Definitions. This property is read-only.
    • [Id <String>]: The unique identifier for an entity. Read-only.
    • [AccessTypes <String>]: deviceManagementConfigurationSettingAccessTypes
    • [Applicability <IMicrosoftGraphDeviceManagementConfigurationSettingApplicability>]: deviceManagementConfigurationSettingApplicability
      • [(Any) <Object>]: This indicates any property can be added to this object.
      • [Description <String>]: description of the setting
      • [DeviceMode <DeviceManagementConfigurationDeviceMode?>]: Describes applicability for the mode the device is in
      • [Platform <DeviceManagementConfigurationPlatforms?>]: Supported platform types.
      • [Technologies <DeviceManagementConfigurationTechnologies?>]: Describes which technology this setting can be deployed with
    • [BaseUri <String>]: Base CSP Path
    • [CategoryId <String>]: Specifies the area group under which the setting is configured in a specified configuration service provider (CSP)
    • [Description <String>]: Description of the item
    • [DisplayName <String>]: Display name of the item
    • [HelpText <String>]: Help text of the item
    • [InfoUrls <String- []>]: List of links more info for the setting can be found at
    • [Keywords <String- []>]: Tokens which to search settings on
    • [Name <String>]: Name of the item
    • [Occurrence <IMicrosoftGraphDeviceManagementConfigurationSettingOccurrence>]: deviceManagementConfigurationSettingOccurrence
      • [(Any) <Object>]: This indicates any property can be added to this object.
      • [MaxDeviceOccurrence <Int32?>]: Maximum times setting can be set on device.
      • [MinDeviceOccurrence <Int32?>]: Minimum times setting can be set on device. A MinDeviceOccurrence of 0 means setting is optional
    • [OffsetUri <String>]: Offset CSP Path from Base
    • [ReferredSettingInformationList <IMicrosoftGraphDeviceManagementConfigurationReferredSettingInformation- []>]: List of referred setting information.
      • [SettingDefinitionId <String>]: Setting definition id that is being referred to a setting. Applicable for reusable setting.
    • [RootDefinitionId <String>]: Root setting definition if the setting is a child setting.
    • [SettingUsage <DeviceManagementConfigurationSettingUsage?>]: Supported setting types
    • [UxBehavior <DeviceManagementConfigurationControlType?>]: Setting control type representation in the UX
    • [Version <String>]: Item Version
    • [Visibility <DeviceManagementConfigurationSettingVisibility?>]: Supported setting types
  • [SettingInstance <IMicrosoftGraphDeviceManagementConfigurationSettingInstance>]: Setting instance within policy
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [SettingDefinitionId <String>]: Setting Definition Id
    • [SettingInstanceTemplateReference <IMicrosoftGraphDeviceManagementConfigurationSettingInstanceTemplateReference>]: Setting instance template reference information
      • [(Any) <Object>]: This indicates any property can be added to this object.
      • [SettingInstanceTemplateId <String>]: Setting instance template id

https://learn.microsoft.com/powershell/module/microsoft.graph.beta.devicemanagement/new-mgbetadevicemanagementcompliancepolicy