New-MgBetaDeviceAppManagementTargetedManagedAppConfiguration
Create new navigation property to targetedManagedAppConfigurations for deviceAppManagement
Note
To view the v1.0 release of this cmdlet, view New-MgDeviceAppManagementTargetedManagedAppConfiguration
Syntax
New-MgBetaDeviceAppManagementTargetedManagedAppConfiguration
[-ResponseHeadersVariable <String>]
[-AdditionalProperties <Hashtable>]
[-AppGroupType <TargetedManagedAppGroupType>]
[-Apps <IMicrosoftGraphManagedMobileApp[]>]
[-Assignments <IMicrosoftGraphTargetedManagedAppPolicyAssignment[]>]
[-CreatedDateTime <DateTime>]
[-CustomSettings <IMicrosoftGraphKeyValuePair[]>]
[-DeployedAppCount <Int32>]
[-DeploymentSummary <IMicrosoftGraphManagedAppPolicyDeploymentSummary>]
[-Description <String>]
[-DisplayName <String>]
[-Id <String>]
[-IsAssigned]
[-LastModifiedDateTime <DateTime>]
[-RoleScopeTagIds <String[]>]
[-Settings <IMicrosoftGraphDeviceManagementConfigurationSetting[]>]
[-TargetedAppManagementLevels <AppManagementLevel>]
[-Version <String>]
[-Headers <IDictionary>]
[-ProgressAction <ActionPreference>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-MgBetaDeviceAppManagementTargetedManagedAppConfiguration
-BodyParameter <IMicrosoftGraphTargetedManagedAppConfiguration>
[-ResponseHeadersVariable <String>]
[-Headers <IDictionary>]
[-ProgressAction <ActionPreference>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Create new navigation property to targetedManagedAppConfigurations for deviceAppManagement
Parameters
-AdditionalProperties
Additional Parameters
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AppGroupType
Indicates a collection of apps to target which can be one of several pre-defined lists of apps or a manually selected list of apps
| Type: | TargetedManagedAppGroupType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Apps
List of apps to which the policy is deployed. To construct, see NOTES section for APPS properties and create a hash table.
| Type: | IMicrosoftGraphManagedMobileApp[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Assignments
Navigation property to list of inclusion and exclusion groups to which the policy is deployed. To construct, see NOTES section for ASSIGNMENTS properties and create a hash table.
| Type: | IMicrosoftGraphTargetedManagedAppPolicyAssignment[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BodyParameter
Configuration used to deliver a set of custom settings as-is to all users in the targeted security group To construct, see NOTES section for BODYPARAMETER properties and create a hash table.
| Type: | IMicrosoftGraphTargetedManagedAppConfiguration |
| 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
The date and time the policy was created.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CustomSettings
A set of string key and string value pairs to be sent to apps for users to whom the configuration is scoped, unalterned by this service To construct, see NOTES section for CUSTOMSETTINGS properties and create a hash table.
| Type: | IMicrosoftGraphKeyValuePair[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeployedAppCount
Count of apps to which the current policy is deployed.
| Type: | Int32 |
| Position: | Named |
| Default value: | 0 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeploymentSummary
The ManagedAppEntity is the base entity type for all other entity types under app management workflow. To construct, see NOTES section for DEPLOYMENTSUMMARY properties and create a hash table.
| Type: | IMicrosoftGraphManagedAppPolicyDeploymentSummary |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
The policy's description.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisplayName
Policy display name.
| 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 |
-IsAssigned
Indicates if the policy is deployed to any inclusion groups or not.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LastModifiedDateTime
Last time the policy was modified.
| Type: | DateTime |
| 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 |
-Settings
List of settings contained in this App Configuration policy 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 |
-TargetedAppManagementLevels
Management levels for apps
| Type: | AppManagementLevel |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Version
Version of the entity.
| Type: | String |
| 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.IMicrosoftGraphTargetedManagedAppConfiguration
System.Collections.IDictionary
Outputs
Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphTargetedManagedAppConfiguration
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.
APPS <IMicrosoftGraphManagedMobileApp- []>: List of apps to which the policy is deployed.
[Id <String>]: The unique identifier for an entity. Read-only.[MobileAppIdentifier <IMicrosoftGraphMobileAppIdentifier>]: The identifier for a mobile app.[(Any) <Object>]: This indicates any property can be added to this object.
[Version <String>]: Version of the entity.
ASSIGNMENTS <IMicrosoftGraphTargetedManagedAppPolicyAssignment- []>: Navigation property to list of inclusion and exclusion groups to which the policy is deployed.
[Id <String>]: The unique identifier for an entity. Read-only.[Source <DeviceAndAppManagementAssignmentSource?>]: Represents source of assignment.[SourceId <String>]: Identifier for resource used for deployment to a group[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 <IMicrosoftGraphTargetedManagedAppConfiguration>: Configuration used to deliver a set of custom settings as-is to all users in the targeted security group
[(Any) <Object>]: This indicates any property can be added to this object.[CustomSettings <IMicrosoftGraphKeyValuePair-[]>]: A set of string key and string value pairs to be sent to apps for users to whom the configuration is scoped, unalterned by this service[Name <String>]: Name for this key-value pair[Value <String>]: Value for this key-value pair
[Settings <IMicrosoftGraphDeviceManagementConfigurationSetting-[]>]: List of settings contained in this App Configuration policy[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
[CreatedDateTime <DateTime?>]: The date and time the policy was created.[Description <String>]: The policy's description.[DisplayName <String>]: Policy display name.[LastModifiedDateTime <DateTime?>]: Last time the policy was modified.[RoleScopeTagIds <String-[]>]: List of Scope Tags for this Entity instance.[Version <String>]: Version of the entity.[Id <String>]: The unique identifier for an entity. Read-only.[AppGroupType <TargetedManagedAppGroupType?>]: Indicates a collection of apps to target which can be one of several pre-defined lists of apps or a manually selected list of apps[Apps <IMicrosoftGraphManagedMobileApp-[]>]: List of apps to which the policy is deployed.[Id <String>]: The unique identifier for an entity. Read-only.[MobileAppIdentifier <IMicrosoftGraphMobileAppIdentifier>]: The identifier for a mobile app.[(Any) <Object>]: This indicates any property can be added to this object.
[Version <String>]: Version of the entity.
[Assignments <IMicrosoftGraphTargetedManagedAppPolicyAssignment-[]>]: Navigation property to list of inclusion and exclusion groups to which the policy is deployed.[Id <String>]: The unique identifier for an entity. Read-only.[Source <DeviceAndAppManagementAssignmentSource?>]: Represents source of assignment.[SourceId <String>]: Identifier for resource used for deployment to a group[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.
[DeployedAppCount <Int32?>]: Count of apps to which the current policy is deployed.[DeploymentSummary <IMicrosoftGraphManagedAppPolicyDeploymentSummary>]: The ManagedAppEntity is the base entity type for all other entity types under app management workflow.[(Any) <Object>]: This indicates any property can be added to this object.[Id <String>]: The unique identifier for an entity. Read-only.[ConfigurationDeployedUserCount <Int32?>]:[ConfigurationDeploymentSummaryPerApp <IMicrosoftGraphManagedAppPolicyDeploymentSummaryPerApp-[]>]:[ConfigurationAppliedUserCount <Int32?>]: Number of users the policy is applied.[MobileAppIdentifier <IMicrosoftGraphMobileAppIdentifier>]: The identifier for a mobile app.
[DisplayName <String>]:[LastRefreshTime <DateTime?>]:[Version <String>]: Version of the entity.
[IsAssigned <Boolean?>]: Indicates if the policy is deployed to any inclusion groups or not.[TargetedAppManagementLevels <AppManagementLevel?>]: Management levels for apps
CUSTOMSETTINGS <IMicrosoftGraphKeyValuePair- []>: A set of string key and string value pairs to be sent to apps for users to whom the configuration is scoped, unalterned by this service
[Name <String>]: Name for this key-value pair[Value <String>]: Value for this key-value pair
DEPLOYMENTSUMMARY <IMicrosoftGraphManagedAppPolicyDeploymentSummary>: The ManagedAppEntity is the base entity type for all other entity types under app management workflow.
[(Any) <Object>]: This indicates any property can be added to this object.[Id <String>]: The unique identifier for an entity. Read-only.[ConfigurationDeployedUserCount <Int32?>]:[ConfigurationDeploymentSummaryPerApp <IMicrosoftGraphManagedAppPolicyDeploymentSummaryPerApp-[]>]:[ConfigurationAppliedUserCount <Int32?>]: Number of users the policy is applied.[MobileAppIdentifier <IMicrosoftGraphMobileAppIdentifier>]: The identifier for a mobile app.[(Any) <Object>]: This indicates any property can be added to this object.
[DisplayName <String>]:[LastRefreshTime <DateTime?>]:[Version <String>]: Version of the entity.
SETTINGS <IMicrosoftGraphDeviceManagementConfigurationSetting- []>: List of settings contained in this App Configuration policy
[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