How To Use the NameCom DNS Plugin¶
This plugin works against the name.com domain registrar and DNS provider. It is assumed that you have already setup an account and purchased domain you will be working against. You must also be using name.com's own DNS hosting.
Setup¶
First, go to the Account API Settings page and create a new API token for your account. Make a note of both the token value and the username associated with the token. If the username is blank immediately following the token creation, try refreshing the page.
Using the Plugin¶
The username is used with the NameComUsername
parameter and the token is used with the NameComTokenSecure
SecureString parameter. If you are using name.com's API testing environment, you'll also need to include NameComUseTestEnv=$true
in your plugin arguments.
Warning
The NameComeToken
parameter is deprecated and will be removed in the next major module version. If you are using it, please migrate to the Secure parameter set.
$pargs = @{
NameComUsername = 'username'
NameComTokenSecure = (Read-Host 'Token' -AsSecureString)
}
New-PACertificate example.com -Plugin NameCom -PluginArgs $pargs