Debug-NetworkController
Queries a Network Controller for detailed diagnostic information.
Syntax
Debug-NetworkController
[-NetworkController] <String>
[-SetupDiagnostics]
[[-IncludeTraces] <Boolean>]
[[-OutputDirectory] <String>]
[[-Credential] <PSCredential>]
[[-RestURI] <String>]
[[-CertificateThumbprint] <String>]
[[-DeviceCredentials] <Hashtable>]
[-ExcludeSlbState]
[<CommonParameters>] Description
The Debug-NetworkController cmdlet queries a Network Controller for detailed diagnostic information.
You can run this cmdlet from a computer that has Layer-3 connectivity to the Representational State Transfer (REST) IP address of the Network Controller. The computer must have the Network Controller REST certificate installed.
Examples
Example 1: Set up logging on nodes and hosts
PS C:\>Debug-NetworkController -NetworkController "NC-0.contoso.cloud.com" -SetupDiagnosticsThis command sets up logging on all Network Controller nodes and hosts.
Example 2: Collect diagnostics data and logs from all nodes and hosts
PS C:\>$Credential = Get-Credential
PS C:\> Debug-NetworkController -NetworkController "NC-0.contoso.cloud.com" -Credential $Credential -OutputDirectory "C:\DiagnosticsData"The first command creates credentials by using the Get-Credential cmdlet, and then stores it in the $Credential variable. The command prompts you for user name and password.
The second command collects diagnostics data and logs from all Network Controller nodes and hosts.
Example 3: Collect diagnostics data only
PS C:\>$Credential = Get-Credential
PS C:\> Debug-NetworkController -NetworkController "NC-0.contoso.cloud.com" -Credential $Credential -OutputDirectory C:\DiagnosticsData -IncludeTraces:$FalseThe first command creates credentials, and then stores it in the $Credential variable.
The second command collects diagnostics data only.
Parameters
-CertificateThumbprint
Specifies the certificate thumbprint to use for the Network Controller. Specify this parameter for certificate deployment.
| Type: | String |
| Position: | 5 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Specifies a credential to use for the Network Controller. Specify this parameter for Kerberos deployment.
| Type: | PSCredential |
| Position: | 3 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeviceCredentials
List of device Credentials. Specify if device credentials are different then Network Controller.
| Type: | Hashtable |
| Position: | 6 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExcludeSlbState
Indicates that this cmdlet excludes SLB State information.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeTraces
Indicates that this cmdlet includes Host Agent and Network Controller Traces.
| Type: | Boolean |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NetworkController
Specifies the name or IP address of a Network Controller node.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OutputDirectory
Specifies the full path of a folder for the results.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RestURI
Specifies the URI to use for Network Controller REST APIs. Specify this parameter for wildcard certificate deployment.
| Type: | String |
| Position: | 4 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SetupDiagnostics
Indicates that logging is to be enabled. If you do not specify this parameter, logs are to be collected, but logging is not enabled.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
None