Editar

Compartir a través de

Copy-NetIntent

  • Reference
Module:
NetworkATC

Moves or copies network intents across different hosts or clusters.

Syntax

Copy-NetIntent
    [[-Name] <String>]
    [-SourceComputerName] <String>
    [-DestinationComputerName] <String>
    [-RemoveSource <Boolean>]
    [-Wait]
    [<CommonParameters>]
Copy-NetIntent
    [[-Name] <String>]
    [-SourceClusterName] <String>
    [-DestinationClusterName] <String>
    [-RemoveSource <Boolean>]
    [-Wait]
    [<CommonParameters>]
Copy-NetIntent
    [[-Name] <String>]
    [-SourceClusterName] <String>
    [-DestinationComputerName] <String>
    [-RemoveSource <Boolean>]
    [-Wait]
    [<CommonParameters>]
Copy-NetIntent
    [[-Name] <String>]
    [-SourceComputerName] <String>
    [-DestinationClusterName] <String>
    [-RemoveSource <Boolean>]
    [-Wait]
    [<CommonParameters>]
Copy-NetIntent
    [-GlobalOverrides]
    [-SourceClusterName] <String>
    [-DestinationComputerName] <String>
    [-RemoveSource <Boolean>]
    [-Wait]
    [<CommonParameters>]
Copy-NetIntent
    [-GlobalOverrides]
    [-SourceClusterName] <String>
    [-DestinationClusterName] <String>
    [-RemoveSource <Boolean>]
    [-Wait]
    [<CommonParameters>]
Copy-NetIntent
    [-GlobalOverrides]
    [-SourceComputerName] <String>
    [-DestinationClusterName] <String>
    [-RemoveSource <Boolean>]
    [-Wait]
    [<CommonParameters>]
Copy-NetIntent
    [-GlobalOverrides]
    [-SourceComputerName] <String>
    [-DestinationComputerName] <String>
    [-RemoveSource <Boolean>]
    [-Wait]
    [<CommonParameters>]

Description

The Copy-NetIntent cmdlet copies or moves a network intent from one host or cluster to another. The source intent is removed if the RemoveSource parameter is provided.

Examples

EXAMPLE 1

Copy-NetIntent -Name "MyIntent" -SourceComputerName "Server01" -DestinationComputerName "Server02"

This example copies a network intent from the standalone device Server01 to the standalone destination device Server02.

Parameters

-DestinationClusterName

Specifies the name of the destination cluster to which the network intent is to be copied.

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

-DestinationComputerName

Specifies the name of the destination computer where the network intent is to be copied.

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

-GlobalOverrides

Specifies that global override settings during the copy operation for any local settings.

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

-RemoveSource

Indicates whether the original network intent should be removed from the source after the copy operation is completed.

Type:Boolean
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceClusterName

Specifies the name of the source cluster that contains the network intent to be copied.

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

-SourceComputerName

Specifies the name of the source computer that holds the network intent to be copied.

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

-Wait

When specified, the command will wait for the network configuration commands to complete or for status confirmation before returning control.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Notes

The copy and removal operation of the intent isn't a transacted operation.