This example shows how to use the New-MgBetaPolicyAppManagementPolicy Cmdlet.
Parameters
-AdditionalProperties
Additional Parameters
Parameter properties
Type:
System.Collections.Hashtable
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
-AppliesTo
Collection of application and service principals to which a policy is applied.
To construct, see NOTES section for APPLIESTO properties and create a hash table.
Runs the command in a mode that only reports what would happen without performing the actions.
Parameter properties
Type:
System.Management.Automation.SwitchParameter
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.
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.
APPLIESTO <IMicrosoftGraphDirectoryObject[]>: Collection of application and service principals to which a policy is applied.
[Id <String>]: The unique identifier for an entity.
Read-only.
[DeletedDateTime <DateTime?>]: Date and time when this object was deleted.
Always null when the object hasn't been deleted.
BODYPARAMETER <IMicrosoftGraphAppManagementPolicy>: appManagementPolicy
[(Any) <Object>]: This indicates any property can be added to this object.
[Description <String>]: Description for this policy.
Required.
[DisplayName <String>]: Display name for this policy.
Required.
[DeletedDateTime <DateTime?>]: Date and time when this object was deleted.
Always null when the object hasn't been deleted.
[Id <String>]: The unique identifier for an entity.
Read-only.
[AppliesTo <IMicrosoftGraphDirectoryObject[]>]: Collection of application and service principals to which a policy is applied.
[Id <String>]: The unique identifier for an entity.
Read-only.
[DeletedDateTime <DateTime?>]: Date and time when this object was deleted.
Always null when the object hasn't been deleted.
[IsEnabled <Boolean?>]: Denotes whether the policy is enabled.
[Restrictions <IMicrosoftGraphCustomAppManagementConfiguration>]: customAppManagementConfiguration
[(Any) <Object>]: This indicates any property can be added to this object.
[KeyCredentials <IMicrosoftGraphKeyCredentialConfiguration[]>]:
[CertificateBasedApplicationConfigurationIds <String[]>]: Collection of GUIDs that represent certificateBasedApplicationConfiguration that is allowed as root and intermediate certificate authorities.
[ExcludeActors <IMicrosoftGraphAppManagementPolicyActorExemptions>]: appManagementPolicyActorExemptions
[(Any) <Object>]: This indicates any property can be added to this object.
[CustomSecurityAttributes <IMicrosoftGraphCustomSecurityAttributeExemption[]>]:
[Id <String>]: The unique identifier for an entity.
Read-only.
[Operator <String>]: customSecurityAttributeComparisonOperator
[MaxLifetime <TimeSpan?>]: String value that indicates the maximum lifetime for key expiration, defined as an ISO 8601 duration.
For example, P4DT12H30M5S represents four days, 12 hours, 30 minutes, and five seconds.
This property is required when restrictionType is set to keyLifetime.
[RestrictForAppsCreatedAfterDateTime <DateTime?>]: Specifies the date from which the policy restriction applies to newly created applications.
For existing applications, the enforcement date can be retroactively applied.
[RestrictionType <String>]: appKeyCredentialRestrictionType
[State <String>]: appManagementRestrictionState
[PasswordCredentials <IMicrosoftGraphPasswordCredentialConfiguration[]>]:
[ExcludeActors <IMicrosoftGraphAppManagementPolicyActorExemptions>]: appManagementPolicyActorExemptions
[MaxLifetime <TimeSpan?>]: String value that indicates the maximum lifetime for password expiration, defined as an ISO 8601 duration.
For example, P4DT12H30M5S represents four days, 12 hours, 30 minutes, and five seconds.
This property is required when restrictionType is set to passwordLifetime.
[RestrictForAppsCreatedAfterDateTime <DateTime?>]: Specifies the date from which the policy restriction applies to newly created applications.
For existing applications, the enforcement date can be retroactively applied.
[RestrictionType <String>]: appCredentialRestrictionType
[State <String>]: appManagementRestrictionState
[ApplicationRestrictions <IMicrosoftGraphCustomAppManagementApplicationConfiguration>]: customAppManagementApplicationConfiguration
[(Any) <Object>]: This indicates any property can be added to this object.
[Audiences <IMicrosoftGraphAudiencesConfiguration>]: audiencesConfiguration
[(Any) <Object>]: This indicates any property can be added to this object.
[AzureAdMultipleOrgs <IMicrosoftGraphAudienceRestriction>]: audienceRestriction
[(Any) <Object>]: This indicates any property can be added to this object.
[ExcludeActors <IMicrosoftGraphAppManagementPolicyActorExemptions>]: appManagementPolicyActorExemptions
[RestrictForAppsCreatedAfterDateTime <DateTime?>]: Specifies the date from which the policy restriction applies to newly created applications.
For existing applications, the enforcement date can be retroactively applied.
[State <String>]: appManagementRestrictionState
[PersonalMicrosoftAccount <IMicrosoftGraphAudienceRestriction>]: audienceRestriction
[IdentifierUris <IMicrosoftGraphIdentifierUriConfiguration>]: identifierUriConfiguration
[(Any) <Object>]: This indicates any property can be added to this object.
[NonDefaultUriAddition <IMicrosoftGraphIdentifierUriRestriction>]: identifierUriRestriction
[(Any) <Object>]: This indicates any property can be added to this object.
[ExcludeActors <IMicrosoftGraphAppManagementPolicyActorExemptions>]: appManagementPolicyActorExemptions
[ExcludeAppsReceivingV2Tokens <Boolean?>]: If true, the restriction isn't enforced for applications that are configured to receive V2 tokens in Microsoft Entra ID; else, the restriction isn't enforced for those applications.
[ExcludeSaml <Boolean?>]: If true, the restriction isn't enforced for SAML applications in Microsoft Entra ID; else, the restriction is enforced for those applications.
[RestrictForAppsCreatedAfterDateTime <DateTime?>]: Specifies the date from which the policy restriction applies to newly created applications.
For existing applications, the enforcement date can be retroactively applied.
[State <String>]: appManagementRestrictionState
[UriAdditionWithoutUniqueTenantIdentifier <IMicrosoftGraphIdentifierUriRestriction>]: identifierUriRestriction
RESTRICTIONS <IMicrosoftGraphCustomAppManagementConfiguration>: customAppManagementConfiguration
[(Any) <Object>]: This indicates any property can be added to this object.
[KeyCredentials <IMicrosoftGraphKeyCredentialConfiguration[]>]:
[CertificateBasedApplicationConfigurationIds <String[]>]: Collection of GUIDs that represent certificateBasedApplicationConfiguration that is allowed as root and intermediate certificate authorities.
[ExcludeActors <IMicrosoftGraphAppManagementPolicyActorExemptions>]: appManagementPolicyActorExemptions
[(Any) <Object>]: This indicates any property can be added to this object.
[CustomSecurityAttributes <IMicrosoftGraphCustomSecurityAttributeExemption[]>]:
[Id <String>]: The unique identifier for an entity.
Read-only.
[Operator <String>]: customSecurityAttributeComparisonOperator
[MaxLifetime <TimeSpan?>]: String value that indicates the maximum lifetime for key expiration, defined as an ISO 8601 duration.
For example, P4DT12H30M5S represents four days, 12 hours, 30 minutes, and five seconds.
This property is required when restrictionType is set to keyLifetime.
[RestrictForAppsCreatedAfterDateTime <DateTime?>]: Specifies the date from which the policy restriction applies to newly created applications.
For existing applications, the enforcement date can be retroactively applied.
[RestrictionType <String>]: appKeyCredentialRestrictionType
[State <String>]: appManagementRestrictionState
[PasswordCredentials <IMicrosoftGraphPasswordCredentialConfiguration[]>]:
[ExcludeActors <IMicrosoftGraphAppManagementPolicyActorExemptions>]: appManagementPolicyActorExemptions
[MaxLifetime <TimeSpan?>]: String value that indicates the maximum lifetime for password expiration, defined as an ISO 8601 duration.
For example, P4DT12H30M5S represents four days, 12 hours, 30 minutes, and five seconds.
This property is required when restrictionType is set to passwordLifetime.
[RestrictForAppsCreatedAfterDateTime <DateTime?>]: Specifies the date from which the policy restriction applies to newly created applications.
For existing applications, the enforcement date can be retroactively applied.
[RestrictionType <String>]: appCredentialRestrictionType
[State <String>]: appManagementRestrictionState
[ApplicationRestrictions <IMicrosoftGraphCustomAppManagementApplicationConfiguration>]: customAppManagementApplicationConfiguration
[(Any) <Object>]: This indicates any property can be added to this object.
[Audiences <IMicrosoftGraphAudiencesConfiguration>]: audiencesConfiguration
[(Any) <Object>]: This indicates any property can be added to this object.
[AzureAdMultipleOrgs <IMicrosoftGraphAudienceRestriction>]: audienceRestriction
[(Any) <Object>]: This indicates any property can be added to this object.
[ExcludeActors <IMicrosoftGraphAppManagementPolicyActorExemptions>]: appManagementPolicyActorExemptions
[RestrictForAppsCreatedAfterDateTime <DateTime?>]: Specifies the date from which the policy restriction applies to newly created applications.
For existing applications, the enforcement date can be retroactively applied.
[State <String>]: appManagementRestrictionState
[PersonalMicrosoftAccount <IMicrosoftGraphAudienceRestriction>]: audienceRestriction
[IdentifierUris <IMicrosoftGraphIdentifierUriConfiguration>]: identifierUriConfiguration
[(Any) <Object>]: This indicates any property can be added to this object.
[NonDefaultUriAddition <IMicrosoftGraphIdentifierUriRestriction>]: identifierUriRestriction
[(Any) <Object>]: This indicates any property can be added to this object.
[ExcludeActors <IMicrosoftGraphAppManagementPolicyActorExemptions>]: appManagementPolicyActorExemptions
[ExcludeAppsReceivingV2Tokens <Boolean?>]: If true, the restriction isn't enforced for applications that are configured to receive V2 tokens in Microsoft Entra ID; else, the restriction isn't enforced for those applications.
[ExcludeSaml <Boolean?>]: If true, the restriction isn't enforced for SAML applications in Microsoft Entra ID; else, the restriction is enforced for those applications.
[RestrictForAppsCreatedAfterDateTime <DateTime?>]: Specifies the date from which the policy restriction applies to newly created applications.
For existing applications, the enforcement date can be retroactively applied.
[State <String>]: appManagementRestrictionState
[UriAdditionWithoutUniqueTenantIdentifier <IMicrosoftGraphIdentifierUriRestriction>]: identifierUriRestriction