Share via

New-MgBetaIdentityGovernanceAppConsentRequest

  • Reference
Module:
Microsoft.Graph.Beta.Identity.Governance

Create new navigation property to appConsentRequests for identityGovernance

Note

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

Syntax

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

Description

Create new navigation property to appConsentRequests for identityGovernance

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

-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.

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

-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.

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.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.