Share via

New-MgIdentityGovernanceAppConsentRequest

  • Reference
Module:
Microsoft.Graph.Identity.Governance

Create new navigation property to appConsentRequests for identityGovernance

Note

To view the beta release of this cmdlet, view New-MgBetaIdentityGovernanceAppConsentRequest

Syntax

New-MgIdentityGovernanceAppConsentRequest
   [-ResponseHeadersVariable <String>]
   [-AdditionalProperties <Hashtable>]
   [-AppDisplayName <String>]
   [-AppId <String>]
   [-Id <String>]
   [-PendingScopes <IMicrosoftGraphAppConsentRequestScope[]>]
   [-UserConsentRequests <IMicrosoftGraphUserConsentRequest[]>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-MgIdentityGovernanceAppConsentRequest
   -BodyParameter <IMicrosoftGraphAppConsentRequest>
   [-ResponseHeadersVariable <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Create new navigation property to appConsentRequests for identityGovernance

Examples

Example 1: List all appConsentRequests

Import-Module Microsoft.Graph.Identity.Governance

Get-MgIdentityGovernanceAppConsentRequest

This example shows how to use the New-MgIdentityGovernanceAppConsentRequest Cmdlet.

To learn about permissions for this resource, see the permissions reference.

Example 2: List all appConsentRequests with at least one userConsentRequest whose status is InProgress

Import-Module Microsoft.Graph.Identity.Governance

Get-MgIdentityGovernanceAppConsentRequest -Filter "userConsentRequests/any (u:u/status eq 'InProgress')"

This example shows how to use the New-MgIdentityGovernanceAppConsentRequest Cmdlet.

To learn about permissions for this resource, see the permissions reference.

Parameters

-AdditionalProperties

Additional Parameters

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

-AppDisplayName

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

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

-AppId

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

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

-BodyParameter

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

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

-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

-PendingScopes

A list of pending scopes waiting for approval. Required. To construct, see NOTES section for PENDINGSCOPES properties and create a hash table.

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

-UserConsentRequests

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

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

System.Collections.IDictionary

Outputs

Microsoft.Graph.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.
  • [PendingScopes <IMicrosoftGraphAppConsentRequestScope- []>]: A list of pending scopes waiting for approval. 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. The display name might not always be available or up to date. For example, if a user changes their display name, the API might show the new value in a future response, but the items associated with the user won't show up as having changed when using delta.
        • [Id <String>]: Unique identifier for the identity.
      • [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.
      • [Stages <IMicrosoftGraphApprovalStage- []>]: A collection of stages in the approval decision.
        • [Id <String>]: The unique identifier for an entity. Read-only.
        • [AssignedToMe <Boolean?>]: Indicates whether the stage is assigned to the calling user to review. Read-only.
        • [DisplayName <String>]: The label provided by the policy creator to identify an approval stage. Read-only.
        • [Justification <String>]: The justification associated with the approval stage 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 stage 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. 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. The display name might not always be available or up to date. For example, if a user changes their display name, the API might show the new value in a future response, but the items associated with the user won't show up as having changed when using delta.
      • [Id <String>]: Unique identifier for the identity.
    • [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.
    • [Stages <IMicrosoftGraphApprovalStage- []>]: A collection of stages in the approval decision.
      • [Id <String>]: The unique identifier for an entity. Read-only.
      • [AssignedToMe <Boolean?>]: Indicates whether the stage is assigned to the calling user to review. Read-only.
      • [DisplayName <String>]: The label provided by the policy creator to identify an approval stage. Read-only.
      • [Justification <String>]: The justification associated with the approval stage 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 stage 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.