< Back

Remove-PAAccount

Sat Jan 18, 2020 7:32 pm

NAME Remove-PAAccount



SYNOPSIS

Remove an ACME account and all associated orders and certificates from the local profile.





SYNTAX

Remove-PAAccount [-ID] <String> [-Deactivate] [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]





DESCRIPTION

This function removes the ACME account from the local profile which also removes any associated orders and

certificates. It will not remove or cleanup copies of certificates that have been exported or installed elsewhere.

It will also not deactivate the account on the ACME server without using -Deactivate. However, with the account's

private key it can't be recovered from the server.





PARAMETERS

-ID <String>

The account id value as returned by the ACME server.



Required? true

Position? 1

Default value

Accept pipeline input? true (ByValue, ByPropertyName)

Accept wildcard characters? false



-Deactivate [<SwitchParameter>]

If specified, a request will be sent to the associated ACME server to deactivate the account. Clients may wish

to do this if the account key is compromised or decommissioned.



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-Force [<SwitchParameter>]

If specified, interactive confirmation prompts will be skipped.



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:\\>Remove-PAAccount 12345



Remove the specified account without deactivation.









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



PS C:\\>Get-PAAccount | Remove-PAAccount -Deactivate -Force



Remove the current account after deactivating it and skip confirmation prompts.











RELATED LINKS

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

Get-PAAccount

New-PAAccount