Edit

Share via


Debug-NetworkControllerConfigurationState

Queries for resources in a failure or warning state.

Syntax

Default (Default)

Debug-NetworkControllerConfigurationState
    [-NetworkController] <String>
    [[-ResourceId] <String>]
    [[-ResourceType] <String>]
    [[-Credential] <PSCredential>]
    [[-RestURI] <String>]
    [[-CertificateThumbprint] <String>]
    [<CommonParameters>]

Description

The Debug-NetworkControllerConfigurationState cmdlet queries for resources that are in a failure or warning state. This cmdlet queries the Network Controller to see if there are any tenant or fabric resources that are in a failure or warning configuration state based on the actual configuration state of the component. This cmdlet also returns detailed information that contains the source of the error, a message, and error code.

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: Query configuration state for REST resources

PS C:\>Debug-NetworkControllerConfigurationState -NetworkController 10.123.177.94

This command queries configuration state for all REST resources for the specified Network Controller.

Parameters

-CertificateThumbprint

Specifies the certificate thumbprint to use for the Network Controller. Specify this parameter for certificate deployment.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:5
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Credential

Specifies a credential to use for the Network Controller. To obtain a PSCredential object, use the Get-Credential cmdlet. Specify this parameter for Kerberos deployment.

Parameter properties

Type:PSCredential
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:3
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-NetworkController

Specifies the name or IP address of a Network Controller node.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:0
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ResourceId

Specifies a REST resource ID.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:1
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ResourceType

Specifies a REST Resource type.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:2
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RestURI

Specifies the URI to use for Network Controller REST APIs. Specify this parameter for wildcard certificate deployment.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:4
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

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

Inputs

None

Outputs

Object