Share via


Close-PAMRequestForControl

Deactivates current PAM requests from other users.

Syntax

Role

Close-PAMRequestForControl
    [-Role] <PAMRole>
    [-Force]
    [<CommonParameters>]

User

Close-PAMRequestForControl
    [-User] <PAMUser>
    [-Force]
    [<CommonParameters>]

Request

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

All

Close-PAMRequestForControl
    [-All]
    [-Force]
    [<CommonParameters>]

Description

This command cancels currently active activation requests. One of the All, Request, Role or User parameters can be specified.

Examples

EXAMPLE 1

Close-PAMRequestForControl -User (Get-PAMUser -PrivDisplayName "contoso.Jen")

This command closes all requests a specified user made.

Parameters

-All

If none of Request, Role or User parameters are specified, all active requests are closed.

Parameter properties

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

Parameter sets

All
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-Force

The cmdlet continues silently without asking the user to confirm.

Parameter properties

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

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Request

Specifies an object returned by an earlier call to Get-PAMRequest.

Parameter properties

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

Parameter sets

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

-Role

Specifies an object returned by an earlier call to Get-PAMRole.

Parameter properties

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

Parameter sets

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

-User

Specifies an object returned by an earlier call to Get-PAMUser.

Parameter properties

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

Parameter sets

User
Position:1
Mandatory:True
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.

Outputs

Microsoft.IdentityManagement.PamCmdlets.Model.PAMRequest

The cmdlet outputs each request that has been canceled.