New-MgBetaDeviceManagementConfigurationPolicy

Module:

Microsoft.Graph.Beta.DeviceManagement Module

Create new navigation property to configurationPolicies for deviceManagement

Syntax

CreateExpanded (Default)

New-MgBetaDeviceManagementConfigurationPolicy
    [-ResponseHeadersVariable <String>]
    [-AdditionalProperties <Hashtable>]
    [-Assignments <IMicrosoftGraphDeviceManagementConfigurationPolicyAssignment[]>]
    [-CreatedDateTime <DateTime>]
    [-CreationSource <String>]
    [-Description <String>]
    [-Id <String>]
    [-LastModifiedDateTime <DateTime>]
    [-Name <String>]
    [-Platforms <DeviceManagementConfigurationPlatforms>]
    [-PriorityMetaData <IMicrosoftGraphDeviceManagementPriorityMetaData>]
    [-RoleScopeTagIds <String[]>]
    [-SettingCount <Int32>]
    [-Settings <IMicrosoftGraphDeviceManagementConfigurationSetting[]>]
    [-Technologies <DeviceManagementConfigurationTechnologies>]
    [-TemplateReference <IMicrosoftGraphDeviceManagementConfigurationPolicyTemplateReference>]
    [-Headers <IDictionary>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Create

New-MgBetaDeviceManagementConfigurationPolicy

    -BodyParameter <IMicrosoftGraphDeviceManagementConfigurationPolicy>
    [-ResponseHeadersVariable <String>]
    [-Headers <IDictionary>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Create new navigation property to configurationPolicies 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 Configuration Policy To construct, see NOTES section for BODYPARAMETER properties and create a hash table.

Parameter properties

Type:	IMicrosoftGraphDeviceManagementConfigurationPolicy
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

-CreatedDateTime

Policy creation date and time

Parameter properties

Type:	DateTime
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

-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

-LastModifiedDateTime

Policy last modification date and time

Parameter properties

Type:	DateTime
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

-PriorityMetaData

Priority metadata of the policy. To construct, see NOTES section for PRIORITYMETADATA properties and create a hash table.

Parameter properties

Type:	IMicrosoftGraphDeviceManagementPriorityMetaData
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

-SettingCount

Number of settings

Parameter properties

Type:	Int32
Default value:	0
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

-TemplateReference

Policy template reference information To construct, see NOTES section for TEMPLATEREFERENCE properties and create a hash table.

Parameter properties

Type:	IMicrosoftGraphDeviceManagementConfigurationPolicyTemplateReference
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.IMicrosoftGraphDeviceManagementConfigurationPolicy

System.Collections.IDictionary

Outputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphDeviceManagementConfigurationPolicy

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 <IMicrosoftGraphDeviceManagementConfigurationPolicy>: Device Management Configuration 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.
• [CreatedDateTime <DateTime?>]: Policy creation date and time
• [CreationSource <String>]: Policy creation source
• [Description <String>]: Policy description
• [LastModifiedDateTime <DateTime?>]: Policy last modification date and time
• [Name <String>]: Policy name
• [Platforms <DeviceManagementConfigurationPlatforms?>]: Supported platform types.
• [PriorityMetaData <IMicrosoftGraphDeviceManagementPriorityMetaData>]: Priority metadata of the policy.
  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [Priority <Int32?>]: Priority of the policy. Valid values 1 to 500
• [RoleScopeTagIds <String- []>]: List of Scope Tags for this Entity instance.
• [SettingCount <Int32?>]: Number of settings
• [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
• [TemplateReference <IMicrosoftGraphDeviceManagementConfigurationPolicyTemplateReference>]: Policy template reference information
  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [TemplateFamily <DeviceManagementConfigurationTemplateFamily?>]: Describes the TemplateFamily for the Template entity
  • [TemplateId <String>]: Template id

PRIORITYMETADATA <IMicrosoftGraphDeviceManagementPriorityMetaData>: Priority metadata of the policy.

• [(Any) <Object>]: This indicates any property can be added to this object.
• [Priority <Int32?>]: Priority of the policy. Valid values 1 to 500

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

TEMPLATEREFERENCE <IMicrosoftGraphDeviceManagementConfigurationPolicyTemplateReference>: Policy template reference information

• [(Any) <Object>]: This indicates any property can be added to this object.
• [TemplateFamily <DeviceManagementConfigurationTemplateFamily?>]: Describes the TemplateFamily for the Template entity
• [TemplateId <String>]: Template id

Related Links

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