Edit

Share via

Set-NetIntentRetryState

Module:
NetworkATC Module

Changes the provisioning state of the goal state for the network intent on a given host.

Syntax

ComputerName (Default) 

Set-NetIntentRetryState
    -Name <String>
    [-ComputerName <String>]
    [-Wait]
    [<CommonParameters>]

Global 

Set-NetIntentRetryState
    [-ClusterName <String>]
    [-ComputerName <String>]
    [-NodeName <String>]
    [-Wait]
    [-GlobalOverrides]
    [<CommonParameters>]

Cluster 

Set-NetIntentRetryState
    -Name <String>
    -NodeName <String>
    [-ClusterName <String>]
    [-Wait]
    [<CommonParameters>]

Description

The Set-NetIntentRetryState cmdlet changes the provisioning state of the goal state for a network intent on a given host. This is useful for resetting failed provisioning attempts, as it resets the RetryRequired state.

Examples

Example 1

Set-NetIntentRetryState -ComputerName "Server01" -Name "MyIntent" -Wait

This example resets the provisioning state for the network intent named MyIntent on the computer Server01 and waits for the operation to complete.

Parameters

-ClusterName

Specifies the name of the cluster.

Parameter properties

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

Parameter sets

Global
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
Cluster
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ComputerName

Specifies the name of the computer.

Parameter properties

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

Parameter sets

ComputerName
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
Global
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-GlobalOverrides

Indicates the global overrides that should be applied when resetting the provisioning state.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False

Parameter sets

Global
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Name

Specifies the name of the network intent to be reset.

Parameter properties

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

Parameter sets

ComputerName
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
Cluster
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-NodeName

Specifies the name of the node within the cluster.

Parameter properties

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

Parameter sets

Global
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Wait

Indicates that the cmdlet should wait for the operation to complete before returning control to the command line.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
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.