New-MgBetaPrivilegedApproval
Add new entity to privilegedApproval
Syntax
New-MgBetaPrivilegedApproval
[-ResponseHeadersVariable <String>]
[-AdditionalProperties <Hashtable>]
[-ApprovalDuration <TimeSpan>]
[-ApprovalState <String>]
[-ApprovalType <String>]
[-ApproverReason <String>]
[-EndDateTime <DateTime>]
[-Id <String>]
[-Request <IMicrosoftGraphPrivilegedRoleAssignmentRequest>]
[-RequestorReason <String>]
[-RoleId <String>]
[-RoleInfo <IMicrosoftGraphPrivilegedRole>]
[-StartDateTime <DateTime>]
[-UserId <String>]
[-Headers <IDictionary>]
[-ProgressAction <ActionPreference>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-MgBetaPrivilegedApproval
-BodyParameter <IMicrosoftGraphPrivilegedApproval>
[-ResponseHeadersVariable <String>]
[-Headers <IDictionary>]
[-ProgressAction <ActionPreference>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Add new entity to privilegedApproval
Examples
Example 1: Using the New-MgBetaPrivilegedApproval Cmdlet
Import-Module Microsoft.Graph.Beta.Identity.Governance
$params = @{
UserId = "userId-value"
RoleId = "roleId-value"
ApprovalType = "approvalType-value"
ApprovalState = "approvalState-value"
ApprovalDuration = "datetime-value"
}
New-MgBetaPrivilegedApproval -BodyParameter $paramsThis example shows how to use the New-MgBetaPrivilegedApproval 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 |
-ApprovalDuration
.
| Type: | TimeSpan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApprovalState
approvalState
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApprovalType
.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApproverReason
.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BodyParameter
privilegedApproval To construct, see NOTES section for BODYPARAMETER properties and create a hash table.
| Type: | IMicrosoftGraphPrivilegedApproval |
| 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 |
-EndDateTime
.
| Type: | DateTime |
| 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 |
-ProgressAction
{{ Fill ProgressAction Description }}
| Type: | ActionPreference |
| Aliases: | proga |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Request
privilegedRoleAssignmentRequest To construct, see NOTES section for REQUEST properties and create a hash table.
| Type: | IMicrosoftGraphPrivilegedRoleAssignmentRequest |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequestorReason
.
| Type: | String |
| 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 |
-RoleId
.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RoleInfo
privilegedRole To construct, see NOTES section for ROLEINFO properties and create a hash table.
| Type: | IMicrosoftGraphPrivilegedRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StartDateTime
.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserId
.
| 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.IMicrosoftGraphPrivilegedApproval
System.Collections.IDictionary
Outputs
Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphPrivilegedApproval
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 <IMicrosoftGraphPrivilegedApproval>: privilegedApproval
[(Any) <Object>]: This indicates any property can be added to this object.[Id <String>]: The unique identifier for an entity. Read-only.[ApprovalDuration <TimeSpan?>]:[ApprovalState <String>]: approvalState[ApprovalType <String>]:[ApproverReason <String>]:[EndDateTime <DateTime?>]:[Request <IMicrosoftGraphPrivilegedRoleAssignmentRequest>]: privilegedRoleAssignmentRequest[(Any) <Object>]: This indicates any property can be added to this object.[Id <String>]: The unique identifier for an entity. Read-only.[AssignmentState <String>]:[Duration <String>]:[Reason <String>]:[RequestedDateTime <DateTime?>]:[RoleId <String>]:[RoleInfo <IMicrosoftGraphPrivilegedRole>]: privilegedRole[(Any) <Object>]: This indicates any property can be added to this object.[Id <String>]: The unique identifier for an entity. Read-only.[Assignments <IMicrosoftGraphPrivilegedRoleAssignment-[]>]:[Id <String>]: The unique identifier for an entity. Read-only.[ExpirationDateTime <DateTime?>]:[IsElevated <Boolean?>]:[ResultMessage <String>]:[RoleId <String>]:[RoleInfo <IMicrosoftGraphPrivilegedRole>]: privilegedRole[UserId <String>]:
[Name <String>]:[Settings <IMicrosoftGraphPrivilegedRoleSettings>]: privilegedRoleSettings[(Any) <Object>]: This indicates any property can be added to this object.[Id <String>]: The unique identifier for an entity. Read-only.[ApprovalOnElevation <Boolean?>]:[ApproverIds <String-[]>]:[ElevationDuration <TimeSpan?>]:[IsMfaOnElevationConfigurable <Boolean?>]:[LastGlobalAdmin <Boolean?>]:[MaxElavationDuration <TimeSpan?>]:[MfaOnElevation <Boolean?>]:[MinElevationDuration <TimeSpan?>]:[NotificationToUserOnElevation <Boolean?>]:[TicketingInfoOnElevation <Boolean?>]:
[Summary <IMicrosoftGraphPrivilegedRoleSummary>]: privilegedRoleSummary[(Any) <Object>]: This indicates any property can be added to this object.[Id <String>]: The unique identifier for an entity. Read-only.[ElevatedCount <Int32?>]:[ManagedCount <Int32?>]:[MfaEnabled <Boolean?>]:[Status <String>]: roleSummaryStatus[UsersCount <Int32?>]:
[Schedule <IMicrosoftGraphGovernanceSchedule>]: governanceSchedule[(Any) <Object>]: This indicates any property can be added to this object.[Duration <TimeSpan?>]: The duration of a role assignment. It is in format of a TimeSpan.[EndDateTime <DateTime?>]: The end time of the role assignment. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Note: if the value is null, it indicates a permanent assignment.[StartDateTime <DateTime?>]: The start time of the role assignment. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z[Type <String>]: The role assignment schedule type. Only Once is supported for now.
[Status <String>]:[TicketNumber <String>]:[TicketSystem <String>]:[Type <String>]:[UserId <String>]:
[RequestorReason <String>]:[RoleId <String>]:[RoleInfo <IMicrosoftGraphPrivilegedRole>]: privilegedRole[StartDateTime <DateTime?>]:[UserId <String>]:
REQUEST <IMicrosoftGraphPrivilegedRoleAssignmentRequest>: privilegedRoleAssignmentRequest
[(Any) <Object>]: This indicates any property can be added to this object.[Id <String>]: The unique identifier for an entity. Read-only.[AssignmentState <String>]:[Duration <String>]:[Reason <String>]:[RequestedDateTime <DateTime?>]:[RoleId <String>]:[RoleInfo <IMicrosoftGraphPrivilegedRole>]: privilegedRole[(Any) <Object>]: This indicates any property can be added to this object.[Id <String>]: The unique identifier for an entity. Read-only.[Assignments <IMicrosoftGraphPrivilegedRoleAssignment-[]>]:[Id <String>]: The unique identifier for an entity. Read-only.[ExpirationDateTime <DateTime?>]:[IsElevated <Boolean?>]:[ResultMessage <String>]:[RoleId <String>]:[RoleInfo <IMicrosoftGraphPrivilegedRole>]: privilegedRole[UserId <String>]:
[Name <String>]:[Settings <IMicrosoftGraphPrivilegedRoleSettings>]: privilegedRoleSettings[(Any) <Object>]: This indicates any property can be added to this object.[Id <String>]: The unique identifier for an entity. Read-only.[ApprovalOnElevation <Boolean?>]:[ApproverIds <String-[]>]:[ElevationDuration <TimeSpan?>]:[IsMfaOnElevationConfigurable <Boolean?>]:[LastGlobalAdmin <Boolean?>]:[MaxElavationDuration <TimeSpan?>]:[MfaOnElevation <Boolean?>]:[MinElevationDuration <TimeSpan?>]:[NotificationToUserOnElevation <Boolean?>]:[TicketingInfoOnElevation <Boolean?>]:
[Summary <IMicrosoftGraphPrivilegedRoleSummary>]: privilegedRoleSummary[(Any) <Object>]: This indicates any property can be added to this object.[Id <String>]: The unique identifier for an entity. Read-only.[ElevatedCount <Int32?>]:[ManagedCount <Int32?>]:[MfaEnabled <Boolean?>]:[Status <String>]: roleSummaryStatus[UsersCount <Int32?>]:
[Schedule <IMicrosoftGraphGovernanceSchedule>]: governanceSchedule[(Any) <Object>]: This indicates any property can be added to this object.[Duration <TimeSpan?>]: The duration of a role assignment. It is in format of a TimeSpan.[EndDateTime <DateTime?>]: The end time of the role assignment. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Note: if the value is null, it indicates a permanent assignment.[StartDateTime <DateTime?>]: The start time of the role assignment. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z[Type <String>]: The role assignment schedule type. Only Once is supported for now.
[Status <String>]:[TicketNumber <String>]:[TicketSystem <String>]:[Type <String>]:[UserId <String>]:
ROLEINFO <IMicrosoftGraphPrivilegedRole>: privilegedRole
[(Any) <Object>]: This indicates any property can be added to this object.[Id <String>]: The unique identifier for an entity. Read-only.[Assignments <IMicrosoftGraphPrivilegedRoleAssignment-[]>]:[Id <String>]: The unique identifier for an entity. Read-only.[ExpirationDateTime <DateTime?>]:[IsElevated <Boolean?>]:[ResultMessage <String>]:[RoleId <String>]:[RoleInfo <IMicrosoftGraphPrivilegedRole>]: privilegedRole[UserId <String>]:
[Name <String>]:[Settings <IMicrosoftGraphPrivilegedRoleSettings>]: privilegedRoleSettings[(Any) <Object>]: This indicates any property can be added to this object.[Id <String>]: The unique identifier for an entity. Read-only.[ApprovalOnElevation <Boolean?>]:[ApproverIds <String-[]>]:[ElevationDuration <TimeSpan?>]:[IsMfaOnElevationConfigurable <Boolean?>]:[LastGlobalAdmin <Boolean?>]:[MaxElavationDuration <TimeSpan?>]:[MfaOnElevation <Boolean?>]:[MinElevationDuration <TimeSpan?>]:[NotificationToUserOnElevation <Boolean?>]:[TicketingInfoOnElevation <Boolean?>]:
[Summary <IMicrosoftGraphPrivilegedRoleSummary>]: privilegedRoleSummary[(Any) <Object>]: This indicates any property can be added to this object.[Id <String>]: The unique identifier for an entity. Read-only.[ElevatedCount <Int32?>]:[ManagedCount <Int32?>]:[MfaEnabled <Boolean?>]:[Status <String>]: roleSummaryStatus[UsersCount <Int32?>]: