New-PAAccount

NAME New-PAAccount



SYNOPSIS

Create a new account on the current ACME server.





SYNTAX

New-PAAccount [[-Contact] <String[]>] [[-KeyLength] <String>] [-AcceptTOS] [-Force] [-ExtraParams <Object>]

[-WhatIf] [-Confirm] [<CommonParameters>]





DESCRIPTION

All certificate requests require a valid account on an ACME server. Adding an email contact is not required. But

without one, certificate expiration notices will not be sent. The account KeyLength is personal preference and

doesn't correspond to the KeyLength of the generated certificates.





PARAMETERS

-Contact <String[]>

One or more email addresses to associate with this account. These addresses will be used by the ACME server to

send certificate expiration notifications or other important account notices.



Required? false

Position? 1

Default value

Accept pipeline input? false

Accept wildcard characters? false



-KeyLength <String>

The type and size of private key to use. For RSA keys, specify a number between 2048-4096 (divisible by 128).

For ECC keys, specify either 'ec-256' or 'ec-384'. Defaults to 'ec-256'.



Required? false

Position? 2

Default value ec-256

Accept pipeline input? false

Accept wildcard characters? false



-AcceptTOS [<SwitchParameter>]

If not specified, the ACME server will throw an error with a link to the current Terms of Service. Using this

switch indicates acceptance of those Terms of Service and is required for successful account creation.



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-Force [<SwitchParameter>]

If specified, confirmation prompts that may have been generated will be skipped.



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-ExtraParams <Object>

This parameter can be ignored and is only used to prevent errors when splatting with more parameters than this

function supports.



Required? false

Position? named

Default value

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

PoshACME.PAAccount





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



PS C:\\>New-PAAccount -AcceptTOS



Create a new account with no contact email and the default key length.









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



PS C:\\>New-PAAccount -Contact user1@example.com -AcceptTOS



Create a new account with the specified email and the default key length.









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



PS C:\\>New-PAAccount -Contact user1@example.com -KeyLength 4096 -AcceptTOS



Create a new account with the specified email and an RSA 4096 bit key.









-------------------------- EXAMPLE 4 --------------------------



PS C:\\>New-PAAccount -KeyLength 'ec-384' -AcceptTOS -Force



Create a new account with no contact email and an ECC key using P-384 curve that ignores any confirmations.











RELATED LINKS

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

Get-PAAccount

Set-PAAccount