< Back
Submit-ACMEChallenge
Post
NAME Submit-ACMEChallenge
SYNOPSIS
Submits a completed Challenge for verification by ACME CA Server.
SYNTAX
Submit-Challenge [-IdentifierRef] <string> [-ChallengeType] <string> [-UseBaseUri <SwitchParameter>]
[-VaultProfile <string>] [-Force <SwitchParameter>] [<CommonParameters>]
DESCRIPTION
After a Challenge has been handled and completed, it needs to be submitted to the ACME CA Server that issued the
Challenge. This cmdlet submits the Challenge of a particular type to the ACME Server to be verified. If the ACME
Server issued multiple Challenges and combinations that will satisfy the validation of ownership of an Identifier,
you can use this cmdlet to submit each Challenge type completed.
PARAMETERS
-IdentifierRef <string>
A reference (ID or alias) to a previously defined Identifier submitted to the ACME CA Server for verification.
Required? true
Position? 0
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Ref <string>
A reference (ID or alias) to a previously defined Identifier submitted to the ACME CA Server for verification.
This is an alias of the IdentifierRef parameter.
Required? true
Position? 0
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ChallengeType <string>
Specifies the ACME Challenge type that should be submitted. This type is expected to be found in the list of
Challenges returned by the ACME CA Server for the associated Identifier and it should already have been
handled previously, either externally to the ACMESharp operations or via the Handler mechanisms within.
Required? true
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-UseBaseUri <SwitchParameter>
Overrides the base URI associated with the target Registration and used for subsequent communication with the
associated ACME CA Server.
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-VaultProfile <string>
Specifies a Vault profile name that will resolve to the Vault instance to be used for all related operations
and storage/retrieval of all related assets.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Force <SwitchParameter>
Forces an attempt to submit the challenge even when the state of the current Identifier authorization is in a
failed or completed state.
Required? false
Position? named
Default value False
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
RELATED LINKS
New-Identifier
Complete-Challenge
SYNOPSIS
Submits a completed Challenge for verification by ACME CA Server.
SYNTAX
Submit-Challenge [-IdentifierRef] <string> [-ChallengeType] <string> [-UseBaseUri <SwitchParameter>]
[-VaultProfile <string>] [-Force <SwitchParameter>] [<CommonParameters>]
DESCRIPTION
After a Challenge has been handled and completed, it needs to be submitted to the ACME CA Server that issued the
Challenge. This cmdlet submits the Challenge of a particular type to the ACME Server to be verified. If the ACME
Server issued multiple Challenges and combinations that will satisfy the validation of ownership of an Identifier,
you can use this cmdlet to submit each Challenge type completed.
PARAMETERS
-IdentifierRef <string>
A reference (ID or alias) to a previously defined Identifier submitted to the ACME CA Server for verification.
Required? true
Position? 0
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Ref <string>
A reference (ID or alias) to a previously defined Identifier submitted to the ACME CA Server for verification.
This is an alias of the IdentifierRef parameter.
Required? true
Position? 0
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ChallengeType <string>
Specifies the ACME Challenge type that should be submitted. This type is expected to be found in the list of
Challenges returned by the ACME CA Server for the associated Identifier and it should already have been
handled previously, either externally to the ACMESharp operations or via the Handler mechanisms within.
Required? true
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
-UseBaseUri <SwitchParameter>
Overrides the base URI associated with the target Registration and used for subsequent communication with the
associated ACME CA Server.
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-VaultProfile <string>
Specifies a Vault profile name that will resolve to the Vault instance to be used for all related operations
and storage/retrieval of all related assets.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Force <SwitchParameter>
Forces an attempt to submit the challenge even when the state of the current Identifier authorization is in a
failed or completed state.
Required? false
Position? named
Default value False
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
RELATED LINKS
New-Identifier
Complete-Challenge