Edit

Debug-NetworkController

  • Reference
Module:
NetworkControllerDiagnostics

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>]
     [<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" -SetupDiagnostics

This 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:$False

The 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

-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