Share via


Close-PAMRequest

Cancel this user's PAM activation requests.

Syntax

Role as PAMRole

Close-PAMRequest
    [[-Role] <PAMRoleForRequest>]
    [<CommonParameters>]

Role as Display Name

Close-PAMRequest
    [[-RoleDisplayName] <String>]
    [<CommonParameters>]

Request as PAMRequest

Close-PAMRequest
    [[-Request] <PAMRequest>]
    [<CommonParameters>]

Description

This cmdlet deactivates one or more of this user's PAM activation requests. The Request, Role or RoleDisplayName parameters must be specified.

Examples

EXAMPLE 1

Close-PAMRequest -RoleDisplayName "IT"

This command closes request the user made earlier for a specific role.

Parameters

-Request

Specifies the request to be deactivated.

Parameter properties

Type:PAMRequest
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Request as PAMRequest
Position:1
Mandatory:False
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-Role

Specifies a role that was returned by Get-PAMRoleForRequest and provided to an earlier call to New-PAMRequest.

Parameter properties

Type:PAMRoleForRequest
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Role as PAMRole
Position:1
Mandatory:False
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-RoleDisplayName

Specifies the display name of the role that was earlier requested for elevation.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

Role as Display Name
Position:1
Mandatory:False
Value from pipeline:True
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.