Share via

New-MgBetaDeviceManagementConfigurationSetting

Module:
Microsoft.Graph.Beta.DeviceManagement Module

Create new navigation property to configurationSettings for deviceManagement

Syntax

CreateExpanded (Default) 

New-MgBetaDeviceManagementConfigurationSetting
    [-ResponseHeadersVariable <String>]
    [-AccessTypes <String>]
    [-AdditionalProperties <Hashtable>]
    [-Applicability <IMicrosoftGraphDeviceManagementConfigurationSettingApplicability>]
    [-BaseUri <String>]
    [-CategoryId <String>]
    [-Description <String>]
    [-DisplayName <String>]
    [-HelpText <String>]
    [-Id <String>]
    [-InfoUrls <String[]>]
    [-Keywords <String[]>]
    [-Name <String>]
    [-Occurrence <IMicrosoftGraphDeviceManagementConfigurationSettingOccurrence>]
    [-OffsetUri <String>]
    [-ReferredSettingInformationList <IMicrosoftGraphDeviceManagementConfigurationReferredSettingInformation[]>]
    [-RiskLevel <DeviceManagementConfigurationSettingRiskLevel>]
    [-RootDefinitionId <String>]
    [-SettingUsage <DeviceManagementConfigurationSettingUsage>]
    [-UxBehavior <DeviceManagementConfigurationControlType>]
    [-Version <String>]
    [-Visibility <DeviceManagementConfigurationSettingVisibility>]
    [-Headers <IDictionary>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Create 

New-MgBetaDeviceManagementConfigurationSetting

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

Description

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

-AccessTypes

deviceManagementConfigurationSettingAccessTypes

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

-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

-Applicability

deviceManagementConfigurationSettingApplicability To construct, see NOTES section for APPLICABILITY properties and create a hash table.

Parameter properties

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

-BaseUri

Base CSP Path

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

deviceManagementConfigurationSettingDefinition To construct, see NOTES section for BODYPARAMETER properties and create a hash table.

Parameter properties

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

-CategoryId

Specify category in which the setting is under. Support $filters.

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

-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

Description of the setting.

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

Name of the setting. For example: Allow Toast.

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

-HelpText

Help text of the setting. Give more details of the setting.

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

-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

-InfoUrls

List of links more info for the setting can be found at.

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

-Keywords

Tokens which to search settings on

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

Name of the item

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

-Occurrence

deviceManagementConfigurationSettingOccurrence To construct, see NOTES section for OCCURRENCE properties and create a hash table.

Parameter properties

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

-OffsetUri

Offset CSP Path from Base

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

-ReferredSettingInformationList

List of referred setting information. To construct, see NOTES section for REFERREDSETTINGINFORMATIONLIST properties and create a hash table.

Parameter properties

Type:

IMicrosoftGraphDeviceManagementConfigurationReferredSettingInformation[]

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

-RiskLevel

Setting RiskLevel

Parameter properties

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

-RootDefinitionId

Root setting definition id if the setting is a child setting.

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

-SettingUsage

Supported setting types

Parameter properties

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

-UxBehavior

Setting control type representation in the UX

Parameter properties

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

-Version

Item 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

-Visibility

Supported setting types

Parameter properties

Type:DeviceManagementConfigurationSettingVisibility
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.IMicrosoftGraphDeviceManagementConfigurationSettingDefinition

System.Collections.IDictionary

Outputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphDeviceManagementConfigurationSettingDefinition

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.

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

BODYPARAMETER <IMicrosoftGraphDeviceManagementConfigurationSettingDefinition>: deviceManagementConfigurationSettingDefinition

  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [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

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

REFERREDSETTINGINFORMATIONLIST <IMicrosoftGraphDeviceManagementConfigurationReferredSettingInformation- []>: List of referred setting information.

  • [SettingDefinitionId <String>]: Setting definition id that is being referred to a setting. Applicable for reusable setting