Share via

New-MgBetaDeviceManagementCompliancePolicy

Module:
Microsoft.Graph.Beta.DeviceManagement Module

Create new navigation property to compliancePolicies for deviceManagement

Syntax

CreateExpanded (Default) 

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>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Create 

New-MgBetaDeviceManagementCompliancePolicy
    -BodyParameter <IMicrosoftGraphDeviceManagementCompliancePolicy>
    [-ResponseHeadersVariable <String>]
    [-Headers <IDictionary>]
    [-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

Parameter properties

Type:Hashtable
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Assignments

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

Parameter properties

Type:

IMicrosoftGraphDeviceManagementConfigurationPolicyAssignment[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-BodyParameter

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

Parameter properties

Type:IMicrosoftGraphDeviceManagementCompliancePolicy
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Create
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-CreationSource

Policy creation source

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Description

Policy description

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Headers

Optional headers that will be added to the request.

Parameter properties

Type:IDictionary
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-Id

The unique identifier for an entity. Read-only.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Name

Policy name

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Platforms

Supported platform types.

Parameter properties

Type:DeviceManagementConfigurationPlatforms
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ResponseHeadersVariable

Optional Response Headers Variable.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:RHV

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RoleScopeTagIds

List of Scope Tags for this Entity instance.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ScheduledActionsForRule

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

Parameter properties

Type:

IMicrosoftGraphDeviceManagementComplianceScheduledActionForRule[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Settings

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

Parameter properties

Type:

IMicrosoftGraphDeviceManagementConfigurationSetting[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Technologies

Describes which technology this setting can be deployed with

Parameter properties

Type:DeviceManagementConfigurationTechnologies
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

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