New-MgBetaDeviceManagementConfigurationPolicy

Create new navigation property to configurationPolicies for deviceManagement

Syntax

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>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-MgBetaDeviceManagementConfigurationPolicy
   -BodyParameter <IMicrosoftGraphDeviceManagementConfigurationPolicy>
   [-ResponseHeadersVariable <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

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

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

-CreatedDateTime

Policy creation date and time

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

-LastModifiedDateTime

Policy last modification date and time

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

-PriorityMetaData

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

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

-SettingCount

Number of settings

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

-TemplateReference

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

Type:IMicrosoftGraphDeviceManagementConfigurationPolicyTemplateReference
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.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>]: 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
  • [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>]: 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

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

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