<< Click to Display Table of Contents >> TestCredential |
Tests an existing scan credential by attempting to connect to a target computer. This verifies that the credential has network access to the target before using it in a scan.
PDQInventory TestCredential -Username <domain\username> -Computer <computerName>
Parameter |
Required |
Description |
|---|---|---|
-Username <domain\username> |
Yes |
The username of the credential to test (e.g., DOMAIN\svcaccount). This must match a credential already saved in PDQ Inventory. |
-Computer <computerName> |
Yes |
The target computer to test connectivity against. Can be a hostname or IP address. |
Exit Code |
Meaning |
|---|---|
0 |
The credential successfully connected to the target computer. |
1 |
Failure. The credential was not found, the connection failed, access was denied, or another error occurred. |
Test a credential against a target computer:
PDQInventory TestCredential -Username DOMAIN\svcaccount -Computer WORKSTATION01
Test a credential using an IP address:
PDQInventory TestCredential -Username DOMAIN\svcaccount -Computer 192.168.1.50
NOTE: The PDQ Inventory background service must be running for this command to work. The -Username must exactly match the username stored in PDQ Inventory Preferences > Credentials.
© 2026 PDQ.com Corporation. All rights reserved.
PDQ.com is a trademark of PDQ.com Corporation. All other product and company names are the property of their respective owners.
Help Version: 20.0.22.0