Logo

Documentation home for Transend tools

  • Invoke-DCTools

    • Home

    Invoke-DCTools

    SYNOPSIS

    Invokes the DigiCert tools.

    SYNTAX

    Invoke-DCTools [-Mode] <String> [[-Path] <String>] [<CommonParameters>]

    DESCRIPTION

    Use Invoke-DCTools to invoke the DigiCert tools in one of several modes, primarily for signing binaries.

    EXAMPLES

    Example 1: Install the tools

    Invoke-DCTools -Mode Install

    Downloads and installs the DigiCert tools. The installer is downloaded to the user’s Download directory and installed in C:\Program Files\DigiCert\tools.

    Example 2: Print the version

    Invoke-DCTools -Mode Version

    Prints the installed version of the DigiCert tools.

    Example 3: Show status

    Invoke-DCTools -Mode Status

    Prints the status of the DigiCert tools. This is useful for determining whether or not the tools are configured and ready for code signing. Errors here likely mean config.psd1 variables are not set correctly.

    Example 3: Sign a single binary

    Invoke-DCTools -Mode Sign -Path 'C:\Temp\app.exe'

    Signs the binary C:\Temp\app.exe.

    Example 4: Sign all binaries in a directory

    Invoke-DCTools -Mode Sign -Path 'C:\Temp'

    Signs all binaries in C:\Temp.

    PARAMETERS

    -Mode

    The DigiCert tools mode to invoke.

    Type: String
Parameter Sets: (All)
Aliases:
Accepted values: Install, Sign, Status, Version

Required: True
Position: 0
Default value: Version
Accept pipeline input: False
Accept wildcard characters: False

    -Path

    The path to a single binary or directory of binaries to sign. Only applies when the Sign mode is selected.

    Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

    CommonParameters

    This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

    INPUTS

    None

    OUTPUTS

    System.Void

    NOTES

    Required config.psd1 configurations

    • DigiCert.ApiKey

      The key used to work with the DigiCert API.

    • DigiCert.ClientCertificateFile

      The path to the client certificate.

    • DigiCert.ClientCertificatePassword

      The password for the client certificate

    • DigiCert.Host

      The server the DigiCert tools communicate with.

    • DigiCert.KeyPairAlias

      The alias of the key pair used for code signing.

    • DigiCert.WindowsSDK

      The path to a Windows SDK that contains signtool.exe. For example, C:\Program Files (x86)\Windows Kits\10\bin\10.0.20348.0.

    • DigiCert.ToolsUri

      The download URI for the DigiCert tools.

    TMCTools configuration options