Get-NetIntentStatus
Displays the consolidated status of all the intent configurations for a node or across multiple nodes in a cluster.
Syntax
ComputerName (Default)
Get-NetIntentStatus
[[-Name] <String>]
[[-ComputerName] <String>]
[-GlobalOverrides]
[<CommonParameters>]
Cluster
Get-NetIntentStatus
[[-Name] <String>]
[-ClusterName] <String>
[-GlobalOverrides]
[<CommonParameters>]
Description
The Get-NetIntentStatus cmdlet retrieves the status of all the network intent
configurations for a standalone host or a cluster.
Examples
Example 1
Get-NetIntentStatus -Name "MyIntent" -ComputerName "Server01"
This example retrieves the status of the network intent configuration MyIntent
for the computer named Server01.
Parameters
-ClusterName
Specifies the name of the cluster for which the network intent status is to be retrieved. When used, the intent "floats" across the cluster. Any node with matching physical adapter names will automatically apply the intended configuration.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Cluster
| Position: | 2 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ComputerName
Specifies the computer name of the target host on which the network intent status is to be retrieved. For standalone hosts, use the local computer name; for scenarios where the script is executed remotely, ensure the current user has administrative privileges on the target machine.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
ComputerName
| Position: | 2 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-GlobalOverrides
Retrieves the global override settings of the network intent status.
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 |
-Name
Defines a unique name that identifies the network intent. Since intents are uniquely determined by their list of physical adapters, the name is used as an identifier to ensure that each intent is distinct.
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 |
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.