< Back
Add-NsxTransportZoneMember
Post
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 :
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 :