< Back

Add-NsxTransportZoneMember

Sat Jan 18, 2020 8:59 pm

NAME Add-NsxTransportZoneMember



SYNOPSIS

Adds a new cluster to an existing Transport Zone.





SYNTAX

Add-NsxTransportZoneMember [-TransportZone] <XmlElement> -Cluster <ClusterInterop[]> [-Wait] [-WaitTimeout

<Int32>] [-Connection <PSObject>] [<CommonParameters>]





DESCRIPTION

An NSX Transport Zone defines the maximum scope for logical switches that

are bound to it. NSX Prepared clusters are added to Transport Zones which

allows VMs on them to attach to any logical switch bound to the transport

zone.



The Add-NsxTransportZoneMember cmdlet adds a new cluster to an existing

Transport Zone on the connected NSX manager.





PARAMETERS

-TransportZone <XmlElement>

PowerNSX Transport Zone object to be updated



Required? true

Position? 2

Default value

Accept pipeline input? true (ByValue)

Accept wildcard characters? false



-Cluster <ClusterInterop[]>

Cluster to be added to the Transport Zone



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Wait [<SwitchParameter>]

Block until transport zone update job is 'COMPLETED' (Will timeout with prompt after -WaitTimeout seconds)

Useful if automating the tz modification so you dont have to write looping code to check status of the tz

before continuing.

NOTE: Not waiting means we do NOT return an updated tz object!



Required? false

Position? named

Default value True

Accept pipeline input? false

Accept wildcard characters? false



-WaitTimeout <Int32>

Timeout waiting for tz update job to complete before user is prompted to continue or cancel. Defaults to 30

seconds.



Required? false

Position? named

Default value 30

Accept pipeline input? false

Accept wildcard characters? false



-Connection <PSObject>

PowerNSX Connection object



Required? false

Position? named

Default value $defaultNSXConnection

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS



-------------------------- EXAMPLE 1 --------------------------



PS C:\\>Get-NsxTransportZone TZ1 | Add-NsxTransportZoneMember -Cluster (Get-cluster)



Adds all clusters from the connected vCenter server to the Transport Zone TZ1









-------------------------- EXAMPLE 2 --------------------------



PS C:\\>Get-NsxTransportZone -Connection $bconn -UniversalOnly | Add-NsxTransportZoneMember -Cluster (Get-cluster

Compute1_b -Server vc-01b.corp.local) -Connection $bconn



Gets the universal transport zone from the NSX server specified by $bconn

and adds the cluster Compute1_b from vCenter server vc-01b.corp.local to it.



This is an example of adding a secondary NSX manager associated VC cluster to

a universal transport zone. Care must be taken to ensure only the clusters

from the associated vCenter server are added to the nsx manager specified

in the connection object (or the default connection)











RELATED LINKS





CommonParameters : False

WorkflowCommonParameters : False

details : @{name=Add-XmlElement; noun=; verb=}

Syntax : @{syntaxItem=System.Object[]}

parameters : @{parameter=System.Object[]}

inputTypes : @{inputType=}

returnValues : @{returnValue=}

aliases : None



remarks : None

alertSet :

description :

examples :

Synopsis :

Add-XmlElement [[-xmlRoot] <XmlElement>] [[-xmlElementName] <string>] [[-xmlElementText]

<string>]



ModuleName : PowerNSX

nonTerminatingErrors :

xmlns:command : http://schemas.microsoft.com/maml/dev/command/2004/10

xmlns:dev : http://schemas.microsoft.com/maml/dev/2004/10

xmlns:maml : http://schemas.microsoft.com/maml/2004/10

Name : Add-XmlElement

Category : Function

Component :

Role :

Functionality :