Editar

Partilhar via

New-NetIntentStatus

  • Reference
Module:
NetworkATC

Displays the consolidated status of all the intent configurations for a node or across multiple nodes in a cluster.

Syntax

New-NetIntentStatus
   [[-Name] <String>]
   [[-ComputerName] <String>]
   [-GlobalOverrides]
   [<CommonParameters>]
New-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.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GlobalOverrides

Retrieves the global override settings of the network intent status.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False