Plugins/Manual.ps1
|
function Get-CurrentPluginType { 'dns-01' } function Add-DnsTxt { [CmdletBinding()] param( [Parameter(Mandatory,Position=0)] [string]$RecordName, [Parameter(Mandatory,Position=1)] [string]$TxtValue, [switch]$ManualNonInteractive, [Parameter(ValueFromRemainingArguments)] $ExtraParams ) Write-Verbose "Saving TXT record to display when Save-DnsTxt is called." if (!$script:ManualTxtAdd) { $script:ManualTxtAdd = @() } $script:ManualTxtAdd += [pscustomobject]@{Record=$RecordName;TxtValue=$TxtValue} <# .SYNOPSIS Stores the TXT record to display when Save-DnsTxt is called. .DESCRIPTION This plugin requires user interaction and should not be used for any certificates that require automated renewals. Renewal operations will skip these. .PARAMETER RecordName The fully qualified name of the TXT record. .PARAMETER TxtValue The value of the TXT record. .PARAMETER ManualNonInteractive If set, prevents user-prompts. Useful for automation scenarios where user input is not possible. .PARAMETER ExtraParams This parameter can be ignored and is only used to prevent errors when splatting with more parameters than this function supports. .EXAMPLE Add-DnsTxt '_acme-challenge.example.com' 'txt-value' Stores TXT record data for the specified site with the specified value. #> } function Remove-DnsTxt { [CmdletBinding()] param( [Parameter(Mandatory,Position=0)] [string]$RecordName, [Parameter(Mandatory,Position=1)] [string]$TxtValue, [switch]$ManualNonInteractive, [Parameter(ValueFromRemainingArguments)] $ExtraParams ) Write-Verbose "Saving TXT record to display when Save-DnsTxt is called." if (!$script:ManualTxtRemove) { $script:ManualTxtRemove = @() } $script:ManualTxtRemove += [pscustomobject]@{Record=$RecordName;TxtValue=$TxtValue} <# .SYNOPSIS Stores the TXT record to display when Save-DnsTxt is called. .DESCRIPTION This plugin requires user interaction and should not be used for any certificates that require automated renewals. Renewal operations will skip these. .PARAMETER RecordName The fully qualified name of the TXT record. .PARAMETER TxtValue The value of the TXT record. .PARAMETER ManualNonInteractive If set, prevents user-prompts. Useful for automation scenarios where user input is not possible. .PARAMETER ExtraParams This parameter can be ignored and is only used to prevent errors when splatting with more parameters than this function supports. .EXAMPLE Remove-DnsTxt '_acme-challenge.example.com' 'txt-value' Stores TXT record data for the specified site with the specified value. #> } function Save-DnsTxt { [CmdletBinding()] param( [switch]$ManualNonInteractive, [Parameter(ValueFromRemainingArguments)] $ExtraParams ) if ($script:ManualTxtAdd -and $script:ManualTxtAdd.Count -gt 0) { Write-Host Write-Host "Please create the following TXT records:" Write-Host "------------------------------------------" $script:ManualTxtAdd | ForEach-Object { Write-Host "$($_.Record) -> $($_.TxtValue)" } Write-Host "------------------------------------------" Write-Host # clear out the variable so we don't notify twice Remove-Variable ManualTxtAdd -Scope Script if (-not $ManualNonInteractive) { Read-Host -Prompt "Press any key to continue." | Out-Null } else { Write-Host "Non-interactive mode, starting wait." Write-Host } } if ($script:ManualTxtRemove -and $script:ManualTxtRemove.Count -gt 0) { Write-Host Write-Host "Please remove the following TXT records:" Write-Host "------------------------------------------" $script:ManualTxtRemove | ForEach-Object { Write-Host "$($_.Record) -> $($_.TxtValue)" } Write-Host "------------------------------------------" Write-Host # clear out the variable so we don't notify twice Remove-Variable ManualTxtRemove -Scope Script } <# .SYNOPSIS Displays the TXT records that need to be manually created or removed by the user. .DESCRIPTION This function outputs the pending TXT records to be created and waits for user confirmation to continue. .PARAMETER ManualNonInteractive If set, prevents user-prompts. Useful for automation scenarios where user input is not possible. .PARAMETER ExtraParams This parameter can be ignored and is only used to prevent errors when splatting with more parameters than this function supports. #> } |