Share via

New-MgBetaDeviceManagementConfigurationPolicyTemplate

  • Reference
Module:
Microsoft.Graph.Beta.DeviceManagement

Create new navigation property to configurationPolicyTemplates for deviceManagement

Syntax

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

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowUnmanagedSettings

Allow unmanaged setting templates

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BaseId

Template base identifier

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BodyParameter

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

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

-Description

Template description

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Template display name

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayVersion

Description of template version

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

-LifecycleState

Describes current lifecycle state of a template

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

-SettingTemplates

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

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

-TemplateFamily

Describes the TemplateFamily for the Template entity

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