New-MgBetaDeviceManagementConfigurationPolicyTemplate

Module:

Microsoft.Graph.Beta.DeviceManagement Module

Create new navigation property to configurationPolicyTemplates for deviceManagement

Syntax

CreateExpanded (Default)

New-MgBetaDeviceManagementConfigurationPolicyTemplate
    [-ResponseHeadersVariable <String>]
    [-AdditionalProperties <Hashtable>]
    [-AllowUnmanagedSettings]
    [-BaseId <String>]
    [-Description <String>]
    [-DisplayName <String>]
    [-DisplayVersion <String>]
    [-Id <String>]
    [-LifecycleState <DeviceManagementTemplateLifecycleState>]
    [-Platforms <DeviceManagementConfigurationPlatforms>]
    [-SettingTemplates <IMicrosoftGraphDeviceManagementConfigurationSettingTemplate[]>]
    [-Technologies <DeviceManagementConfigurationTechnologies>]
    [-TemplateFamily <DeviceManagementConfigurationTemplateFamily>]
    [-Headers <IDictionary>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Create

New-MgBetaDeviceManagementConfigurationPolicyTemplate

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

Description

Create new navigation property to configurationPolicyTemplates 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

-AllowUnmanagedSettings

Allow unmanaged setting templates

Parameter properties

Type:	SwitchParameter
Default value:	False
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

-BaseId

Template base identifier

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

-BodyParameter

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

Parameter properties

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

-Description

Template 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

-DisplayName

Template display 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

-DisplayVersion

Description of template version

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

-LifecycleState

Describes current lifecycle state of a template

Parameter properties

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

-SettingTemplates

Setting templates To construct, see NOTES section for SETTINGTEMPLATES properties and create a hash table.

Parameter properties

Type:	IMicrosoftGraphDeviceManagementConfigurationSettingTemplate[]
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

-TemplateFamily

Describes the TemplateFamily for the Template entity

Parameter properties

Type:	DeviceManagementConfigurationTemplateFamily
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.IMicrosoftGraphDeviceManagementConfigurationPolicyTemplate

System.Collections.IDictionary

Outputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphDeviceManagementConfigurationPolicyTemplate

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.

BODYPARAMETER <IMicrosoftGraphDeviceManagementConfigurationPolicyTemplate>: Device Management Configuration Policy Template

• [(Any) <Object>]: This indicates any property can be added to this object.
• [Id <String>]: The unique identifier for an entity. Read-only.
• [AllowUnmanagedSettings <Boolean?>]: Allow unmanaged setting templates
• [BaseId <String>]: Template base identifier
• [Description <String>]: Template description
• [DisplayName <String>]: Template display name
• [DisplayVersion <String>]: Description of template version
• [LifecycleState <DeviceManagementTemplateLifecycleState?>]: Describes current lifecycle state of a template
• [Platforms <DeviceManagementConfigurationPlatforms?>]: Supported platform types.
• [SettingTemplates <IMicrosoftGraphDeviceManagementConfigurationSettingTemplate- []>]: Setting templates
  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [SettingDefinitions <IMicrosoftGraphDeviceManagementConfigurationSettingDefinition- []>]: List of related Setting Definitions
    • [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
  • [SettingInstanceTemplate <IMicrosoftGraphDeviceManagementConfigurationSettingInstanceTemplate>]: Setting Instance Template
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [IsRequired <Boolean?>]: Indicates if a policy must specify this setting.
    • [SettingDefinitionId <String>]: Setting Definition Id
    • [SettingInstanceTemplateId <String>]: Setting Instance Template Id
• [Technologies <DeviceManagementConfigurationTechnologies?>]: Describes which technology this setting can be deployed with
• [TemplateFamily <DeviceManagementConfigurationTemplateFamily?>]: Describes the TemplateFamily for the Template entity

SETTINGTEMPLATES <IMicrosoftGraphDeviceManagementConfigurationSettingTemplate- []>: Setting templates

• [Id <String>]: The unique identifier for an entity. Read-only.
• [SettingDefinitions <IMicrosoftGraphDeviceManagementConfigurationSettingDefinition- []>]: List of related Setting Definitions
  • [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
• [SettingInstanceTemplate <IMicrosoftGraphDeviceManagementConfigurationSettingInstanceTemplate>]: Setting Instance Template
  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [IsRequired <Boolean?>]: Indicates if a policy must specify this setting.
  • [SettingDefinitionId <String>]: Setting Definition Id
  • [SettingInstanceTemplateId <String>]: Setting Instance Template Id

Related Links

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