Share via

New-MgBetaDeviceManagementReusableSetting

  • Reference
Module:
Microsoft.Graph.Beta.DeviceManagement

Create new navigation property to reusableSettings for deviceManagement

Syntax

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

Description

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

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

-AdditionalProperties

Additional Parameters

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

-Applicability

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

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

-BaseUri

Base CSP Path

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

-BodyParameter

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

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

-CategoryId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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

Description of the setting.

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

-DisplayName

Name of the setting. For example: Allow Toast.

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

-HelpText

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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

-InfoUrls

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

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

-Keywords

Tokens which to search settings on

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

-Name

Name of the item

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

-Occurrence

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

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

-OffsetUri

Offset CSP Path from Base

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

-ReferredSettingInformationList

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

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

-RiskLevel

Setting RiskLevel

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

-RootDefinitionId

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

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

-SettingUsage

Supported setting types

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

-UxBehavior

Setting control type representation in the UX

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

-Version

Item Version

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

-Visibility

Supported setting types

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