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

Permissions

Permission type Permissions (from least to most privileged)
Delegated (work or school account) DeviceManagementConfiguration.ReadWrite.All,
Delegated (personal Microsoft account) Not supported
Application DeviceManagementConfiguration.ReadWrite.All,

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>]: Specify category in which the setting is under. Support $filters.
      • [Description <String>]: Description of the setting.
      • [DisplayName <String>]: Name of the setting. For example: Allow Toast.
      • [HelpText <String>]: Help text of the setting. Give more details of the setting.
      • [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
      • [RiskLevel <DeviceManagementConfigurationSettingRiskLevel?>]: Setting RiskLevel
      • [RootDefinitionId <String>]: Root setting definition id 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>]: Specify category in which the setting is under. Support $filters.
    • [Description <String>]: Description of the setting.
    • [DisplayName <String>]: Name of the setting. For example: Allow Toast.
    • [HelpText <String>]: Help text of the setting. Give more details of the setting.
    • [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
    • [RiskLevel <DeviceManagementConfigurationSettingRiskLevel?>]: Setting RiskLevel
    • [RootDefinitionId <String>]: Root setting definition id 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