Revoke-PAAuthorization

NAME Revoke-PAAuthorization



SYNOPSIS

Revoke the authorization associated with an ACME identifier.





SYNTAX

Revoke-PAAuthorization [-AuthURLs] <String[]> [[-Account] <Object>] [-Force] [-WhatIf] [-Confirm]

[<CommonParameters>]





DESCRIPTION

Many ACME server implementations cache succesful authorizations for a certain amount of time to avoid requiring an

account to re-authorize identifiers for additional orders submitted during the cache window.



This can make testing authorization challenges in a client more cumbersome by having to create new orders with

uncached identifiers. This function allows you to revoke those cached authorizations so that subsequent orders

will go through the full challenge validation process.





PARAMETERS

-AuthURLs <String[]>

One or more authorization URLs. You also pipe in one or more PoshACME.PAOrder objects.



Required? true

Position? 1

Default value

Accept pipeline input? true (ByValue, ByPropertyName)

Accept wildcard characters? false



-Account <Object>

An existing ACME account object such as the output from Get-PAAccount. If no account is specified, the current

account will be used.



Required? false

Position? 2

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Force [<SwitchParameter>]

If specified, no confirmation prompts will be presented.



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Confirm [<SwitchParameter>]



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS



-------------------------- EXAMPLE 1 --------------------------



PS C:\\>Revoke-PAAuthorization https://acme.example.com/authz/1234567



Revoke the authorization for the specified URL using the current account.









-------------------------- EXAMPLE 2 --------------------------



PS C:\\>Get-PAOrder | Revoke-PAAuthorization -Force



Revoke all authorizations for the current order on the current account without confirmation prompts.









-------------------------- EXAMPLE 3 --------------------------



PS C:\\>Get-PAOrder -List | Revoke-PAAuthorizations



Revoke all authorizations for all orders on the current account.











RELATED LINKS

Project: https://github.com/rmbolger/Posh-ACME

Get-PAAuthorizations

Get-PAOrder