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.
Examples¶
Example 1: Revoke an Authorization¶
Revoke-PAAuthorization https://acme.example.com/authz/1234567
Revoke the authorization for the specified URL using the current account.
Example 2: Revoke Order Authorizations¶
Get-PAOrder | Revoke-PAAuthorization -Force
Revoke all authorizations for the current order on the current account without confirmation prompts.
Example 3: Revoke All Order Authorizations¶
Get-PAOrder -List | Revoke-PAAuthorizations
Revoke all authorizations for all orders on the current account.
Parameters¶
-AuthURLs¶
One or more authorization URLs. You also pipe in one or more PoshACME.PAOrder objects.
Type: String[]
Parameter Sets: (All)
Aliases: authorizations
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-Account¶
An existing ACME account object such as the output from Get-PAAccount. If no account is specified, the current account will be used.
Type: Object
Parameter Sets: (All)
Aliases:
Required: False
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Force¶
If specified, no confirmation prompts will be presented.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 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
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm¶
Prompts you for confirmation before running the cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters¶
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Inputs¶
System.String¶
The URI of the authorization object.