New-MgBetaIdentityGovernanceAppConsentRequest

Module:

Microsoft.Graph.Beta.Identity.Governance Module

Create new navigation property to appConsentRequests for identityGovernance

Note

To view the v1.0 release of this cmdlet, view New-MgIdentityGovernanceAppConsentRequest

Syntax

CreateExpanded (Default)

New-MgBetaIdentityGovernanceAppConsentRequest
    [-ResponseHeadersVariable <String>]
    [-AdditionalProperties <Hashtable>]
    [-AppDisplayName <String>]
    [-AppId <String>]
    [-ConsentType <String>]
    [-Id <String>]
    [-PendingScopes <IMicrosoftGraphAppConsentRequestScope[]>]
    [-UserConsentRequests <IMicrosoftGraphUserConsentRequest[]>]
    [-Headers <IDictionary>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Create

New-MgBetaIdentityGovernanceAppConsentRequest
    -BodyParameter <IMicrosoftGraphAppConsentRequest>
    [-ResponseHeadersVariable <String>]
    [-Headers <IDictionary>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Create new navigation property to appConsentRequests for identityGovernance

Parameters

-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

-AppDisplayName

The display name of the app for which consent is requested. Required. Supports $filter (eq only) and $orderby.

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

-AppId

The identifier of the application. Required. Supports $filter (eq only) and $orderby.

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

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

Parameter properties

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

-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

-ConsentType

The consent type of the request. Possible values are: Static and Dynamic. These represent static and dynamic permissions, respectively, requested in the consent workflow. Supports $filter (eq only) and $orderby. Required.

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

-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

-PendingScopes

A list of pending scopes waiting for approval. This is empty if the consentType is Static. Required. To construct, see NOTES section for PENDINGSCOPES properties and create a hash table.

Parameter properties

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

-UserConsentRequests

A list of pending user consent requests. Supports $filter (eq). To construct, see NOTES section for USERCONSENTREQUESTS properties and create a hash table.

Parameter properties

Type:	IMicrosoftGraphUserConsentRequest[]
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.IMicrosoftGraphAppConsentRequest

System.Collections.IDictionary

Outputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphAppConsentRequest

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 <IMicrosoftGraphAppConsentRequest>: appConsentRequest

• [(Any) <Object>]: This indicates any property can be added to this object.
• [Id <String>]: The unique identifier for an entity. Read-only.
• [AppDisplayName <String>]: The display name of the app for which consent is requested. Required. Supports $filter (eq only) and $orderby.
• [AppId <String>]: The identifier of the application. Required. Supports $filter (eq only) and $orderby.
• [ConsentType <String>]: The consent type of the request. Possible values are: Static and Dynamic. These represent static and dynamic permissions, respectively, requested in the consent workflow. Supports $filter (eq only) and $orderby. Required.
• [PendingScopes <IMicrosoftGraphAppConsentRequestScope- []>]: A list of pending scopes waiting for approval. This is empty if the consentType is Static. Required.
  • [DisplayName <String>]: The name of the scope.
• [UserConsentRequests <IMicrosoftGraphUserConsentRequest- []>]: A list of pending user consent requests. Supports $filter (eq).
  • [ApprovalId <String>]: The identifier of the approval of the request.
  • [CompletedDateTime <DateTime?>]: The request completion date time.
  • [CreatedBy <IMicrosoftGraphIdentitySet>]: identitySet
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [Application <IMicrosoftGraphIdentity>]: identity
      • [(Any) <Object>]: This indicates any property can be added to this object.
      • [DisplayName <String>]: The display name of the identity. This property is read-only.
      • [Id <String>]: The identifier of the identity. This property is read-only.
    • [Device <IMicrosoftGraphIdentity>]: identity
    • [User <IMicrosoftGraphIdentity>]: identity
  • [CreatedDateTime <DateTime?>]: The request creation date time.
  • [CustomData <String>]: Free text field to define any custom data for the request. Not used.
  • [Status <String>]: The status of the request. Not nullable. The possible values are: Canceled, Denied, Failed, Granted, PendingAdminDecision, PendingApproval, PendingProvisioning, PendingScheduleCreation, Provisioned, Revoked, and ScheduleCreated. Not nullable.
  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [Approval <IMicrosoftGraphApproval>]: approval
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [Id <String>]: The unique identifier for an entity. Read-only.
    • [Steps <IMicrosoftGraphApprovalStep- []>]: Used to represent the decision associated with a single step in the approval process configured in approvalStage.
      • [Id <String>]: The unique identifier for an entity. Read-only.
      • [AssignedToMe <Boolean?>]: Indicates whether the step is assigned to the calling user to review. Read-only.
      • [DisplayName <String>]: The label provided by the policy creator to identify an approval step. Read-only.
      • [Justification <String>]: The justification associated with the approval step decision.
      • [ReviewResult <String>]: The result of this approval record. Possible values include: NotReviewed, Approved, Denied.
      • [ReviewedBy <IMicrosoftGraphIdentity>]: identity
      • [ReviewedDateTime <DateTime?>]: The date and time when a decision was recorded. The date and time information uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.
      • [Status <String>]: The step status. Possible values: InProgress, Initializing, Completed, Expired. Read-only.
  • [Reason <String>]: The user's justification for requiring access to the app. Supports $filter (eq only) and $orderby.

PENDINGSCOPES <IMicrosoftGraphAppConsentRequestScope- []>: A list of pending scopes waiting for approval. This is empty if the consentType is Static. Required.

• [DisplayName <String>]: The name of the scope.

USERCONSENTREQUESTS <IMicrosoftGraphUserConsentRequest- []>: A list of pending user consent requests. Supports $filter (eq).

• [ApprovalId <String>]: The identifier of the approval of the request.
• [CompletedDateTime <DateTime?>]: The request completion date time.
• [CreatedBy <IMicrosoftGraphIdentitySet>]: identitySet
  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [Application <IMicrosoftGraphIdentity>]: identity
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [DisplayName <String>]: The display name of the identity. This property is read-only.
    • [Id <String>]: The identifier of the identity. This property is read-only.
  • [Device <IMicrosoftGraphIdentity>]: identity
  • [User <IMicrosoftGraphIdentity>]: identity
• [CreatedDateTime <DateTime?>]: The request creation date time.
• [CustomData <String>]: Free text field to define any custom data for the request. Not used.
• [Status <String>]: The status of the request. Not nullable. The possible values are: Canceled, Denied, Failed, Granted, PendingAdminDecision, PendingApproval, PendingProvisioning, PendingScheduleCreation, Provisioned, Revoked, and ScheduleCreated. Not nullable.
• [Id <String>]: The unique identifier for an entity. Read-only.
• [Approval <IMicrosoftGraphApproval>]: approval
  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [Steps <IMicrosoftGraphApprovalStep- []>]: Used to represent the decision associated with a single step in the approval process configured in approvalStage.
    • [Id <String>]: The unique identifier for an entity. Read-only.
    • [AssignedToMe <Boolean?>]: Indicates whether the step is assigned to the calling user to review. Read-only.
    • [DisplayName <String>]: The label provided by the policy creator to identify an approval step. Read-only.
    • [Justification <String>]: The justification associated with the approval step decision.
    • [ReviewResult <String>]: The result of this approval record. Possible values include: NotReviewed, Approved, Denied.
    • [ReviewedBy <IMicrosoftGraphIdentity>]: identity
    • [ReviewedDateTime <DateTime?>]: The date and time when a decision was recorded. The date and time information uses ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.
    • [Status <String>]: The step status. Possible values: InProgress, Initializing, Completed, Expired. Read-only.
• [Reason <String>]: The user's justification for requiring access to the app. Supports $filter (eq only) and $orderby.

Related Links

• https://learn.microsoft.com/powershell/module/microsoft.graph.beta.identity.governance/new-mgbetaidentitygovernanceappconsentrequest