James Bowling

James Bowling

Staff Architect at VMware

The Virtual Distributed Braintrust

Export/Import vCloud Director 5.1 OrgNetworks with PowerCLI

6 minute read

I decided to provide an extension on the last post I did, Creating OrgNetworks in vCloud Director 5.1 with PowerCLI.  I had a need for being able to export OrgNetworks from a vCD 5.1 environment and be able to replicate/rebuild/recreate the OrgNetworks from the exported list.  Due to this need I attempted to create a PowerCLI script to do this for me.  Here is what I came up with, mind you it isn’t the sexiest script in the world but it worked for my needs and can be easily adjusted to fit yours.  

Here is the script for the export:

>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

#
# Export-OrgNetworks.ps1
# Created by: James Bowling <james.bowling@vsential.com>
#

<#
.SYNOPSIS
Exports OrgNetworks to a CSV file export

.DESCRIPTION
Use this script to export all OrgNetworks in a specified VDC to a CSV file.

.SYNTAX
Export-OrgNetworks.ps1 -s cloud.vsential.lab -v 1001 -f OrgNetworks.csv

.PARAMETER Server
The vCloud Director server you want to connect to.

.PARAMETER Vdc
The oVDC you want to export OrgNetworks from.

.PARAMETER File
The output path and filename for the export to go to.

.EXAMPLE
Export-OrgNetworks.ps1 -s vcloud.vsential.lab -v 1001 -f OrgNetworks-Exported.csv
This command will export the OrgNetworks of oVDC 1001 into .\OrgNetworks-Exported.csv.
#>

# Take in command line arguments for vCD, oVDC, and output file.
param(
[parameter(Mandatory = $true, HelpMessage="vCD Server")][alias("-server","s")][ValidateNotNullOrEmpty()][string[]]$CIServer,
[parameter(Mandatory = $true, HelpMessage="OrgVDC")][alias("-vdc","v")][ValidateNotNullOrEmpty()][string[]]$OrgVdc,
[parameter(Mandatory = $true, HelpMessage="Filename")][alias("-file","f")][ValidateNotNullOrEmpty()][string[]]$OrgNetFile
)

# Connect to vCloud Director server
Write-Host "Connecting to $CIServer..."
Connect-CIServer $CIServer | Out-Null

# Export OrgNetworks to a CSV File
Write-Host "Exporting all OrgNetworks in $OrgVdc to $OrgNetFile"

$report = @()

$report += Get-OrgNetwork | Foreach {
$_ | Select Org,Name,Description,NetworkType,Gateway,Netmask,PrimaryDns,SecondaryDns,NetworkPool,StaticIPPool,ExternalNetwork,Id,@{N="IsShared";E={($_.extensiondata.isshared)}}
}

$report | Export-Csv -NoTypeInformation -Path $($OrgNetFile)

Write-Host "Export complete to $OrgNetFile"

# Disconnect from vCloud Director server
Disconnect-CIServer $CIServer -Confirm:$false

Pretty straight forward deal here.  You run it like so:

.\Export-OrgNetworks.ps1 -s vcloud.vsential.lab -v 1001 -f OrgNetworks.csv

For an explanation of the parameters just look in the script or run get-help Export-OrgNetworks.ps1.  Now that we have the wonderful CSV with our exported data, I needed to be able to parse and recreate these networks from the CSV.  You need to understand that the Edge Gateway devices and all other required information was pre-built in the vCD environment.  So for those of you who are looking to use this to rebuild your networks from scratch, please build the necessary backing devices as this will only build the OrgNetworks.  Here is what I came up with this, again, not the sexiest script in the world but works well for me:

>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167

#
# Rebuild-OrgNetworks.ps1
# Created by: James Bowling <james.bowling@vsential.com>
#

<#
.SYNOPSIS
Recreates OrgNetworks from a CSV file export

.DESCRIPTION
Based on information within a CSV file of exported OrgNetworks, one can recreate
all OrgNetworks from this file.

.PARAMETER server
The vCloud Director server FQDN.

.PARAMETER org
The Organization name to create networks in.

.PARAMETER vdc
The OrgVDC within the Org to create the networks for.

.PARAMETER file
The input csv file of the exported OrgNetworks.

.EXAMPLE
Rebuild-OrgNetworks -s vcloud.vsential.lab -o 1002 -v 1001 -f OrgNetworks-Exported.csv
This command will rebuild the OrgNetworks in said file in said OrgVdc on said vCD Server.

.NOTES
TODO: Build checks into the code.
TODO: Add rebuild of services, if any, on routed networks.
#>

# Take in command line arguments
param(
[parameter(Mandatory = $true, HelpMessage="vCD Server")][alias("-server","s")][ValidateNotNullOrEmpty()][string[]]$CIServer,
[parameter(Mandatory = $true, HelpMessage="Org")][alias("-org","o")][ValidateNotNullOrEmpty()][string[]]$OrgName,
[parameter(Mandatory = $true, HelpMessage="OrgVDC")][alias("-vdc","v")][ValidateNotNullOrEmpty()][string[]]$OrgVdc,
[parameter(Mandatory = $true, HelpMessage="Filename")][alias("-file","f")][ValidateNotNullOrEmpty()][string[]]$OrgNetFile
)

function debug {
Write-Host ""
Write-Host "Debug Information:"
Write-Host "Org Network Name: $orgNetName"
Write-Host "Org Name: "$org.name
Write-Host "Created Network Name: "$mynetwork.name
if ($_.networktype -eq "Routed"){ Write-Host "Edge Gateway Href: "$edgegateway.href }
if ($_.networktype -eq "Routed|Isolated"){ Write-Host "IP Addresses: "$ippool[0] $ippool[1] }
if ($_.networktype -eq "Direct"){ Write-Host "External Network Href: "$externalnetwork.href }
Write-Host ""
}

function createrouted {
$orgNetName = $_.name
$org = Get-OrgVdc $OrgName | Get-CIView
$edgegateway = Search-Cloud -QueryType EdgeGateway | Get-CIView | ?{$_.name -like "$OrgName*"}
Write-Host "Creating Routed OrgNetwork: $orgNetName in $OrgName"

$mynetwork = new-object vmware.vimautomation.cloud.views.orgvdcnetwork
$mynetwork.name = $orgNetName
$mynetwork.edgegateway = $edgegateway.href
$mynetwork.isshared = $_.isshared

$mynetwork.configuration = new-object vmware.vimautomation.cloud.views.networkconfiguration
$mynetwork.configuration.fencemode = "natRouted"

$mynetwork.configuration.ipscopes = new-object vmware.vimautomation.cloud.views.ipscopes
$scope = new-object vmware.vimautomation.cloud.views.ipscope
$scope.gateway = $_.gateway
$scope.netmask = $_.netmask
$scope.dns1 = $_.primarydns
$scope.dns2 = $_.secondarydns

$scope.ipranges = new-object vmware.vimautomation.cloud.views.ipranges
$scope.ipranges.iprange = new-object vmware.vimautomation.cloud.views.iprange

# Split StaticIPPools string for separation of start/end addresses
$ippool = @()
$ippool += @($_.staticippool.split("-").trim())

$scope.ipranges.iprange[0].startaddress = $ippool[0]
$scope.ipranges.iprange[0].endaddress = $ippool[1]

$mynetwork.configuration.ipscopes.ipscope += $scope

$result = $org.CreateNetwork($mynetwork)
if ($debug -eq "1"){ debug }
}

function createdirect {
# Get External Network HRef Value
Write-Host "Retrieving External Network HRef Id..."
$externalnetworkname = $_.externalnetwork
$externalnetwork = Get-ExternalNetwork | Get-CIView | ?{$_.name -like "$externalnetworkname*"}

$orgNetName = $_.Name
$org = Get-OrgVdc $OrgName | Get-CIView
Write-Host "Creating Direct OrgNetwork: $orgNetName in $OrgName"

$mynetwork = new-object vmware.vimautomation.cloud.views.orgvdcnetwork
$mynetwork.name = $OrgNetName
$mynetwork.isshared = $_.isshared

$mynetwork.configuration = new-object vmware.vimautomation.cloud.views.networkconfiguration
$mynetwork.configuration.fencemode = "bridged"

$mynetwork.configuration.parentnetwork = New-Object vmware.vimautomation.cloud.views.reference
$mynetwork.configuration.parentnetwork.href = $externalnetwork.href

$result = $org.CreateNetwork($mynetwork)
if ($debug -eq "1"){ debug }
}

function createisolated {
$orgNetName = $_.Name
$org = Get-OrgVdc $OrgName | Get-CIView
Write-Host "Creating Isolated OrgNetwork: $orgNetName in $OrgName"

$mynetwork = new-object vmware.vimautomation.cloud.views.orgvdcnetwork
$mynetwork.name = $orgNetName
$mynetwork.isshared = $_.isshared

$mynetwork.configuration = new-object vmware.vimautomation.cloud.views.networkconfiguration
$mynetwork.configuration.fencemode = "isolated"

$mynetwork.configuration.ipscopes = new-object vmware.vimautomation.cloud.views.ipscopes
$scope = new-object vmware.vimautomation.cloud.views.ipscope
$scope.gateway = $_.gateway
$scope.netmask = $_.netmask
$scope.dns1 = $_.primarydns
$scope.dns2 = $_.secondarydns

$scope.ipranges = new-object vmware.vimautomation.cloud.views.ipranges
$scope.ipranges.iprange = new-object vmware.vimautomation.cloud.views.iprange

# Split StaticIPPools string for separation of start/end addresses
$ippool = @()
$ippool += @($_.staticippool.split("-").trim())

$scope.ipranges.iprange[0].startaddress = $ippool[0]
$scope.ipranges.iprange[0].endaddress = $ippool[1]

$mynetwork.configuration.ipscopes.ipscope += $scope

$result = $org.CreateNetwork($mynetwork)
if ($debug -eq "1"){ debug }
}

# Set to 1 to enable debug output
$debug = "0"

# Connect to vCloud Director server
Connect-CIServer $CIServer | Out-Null

# Read in OrgNetwork CSV File
$OrgNetworks = Import-CSV $OrgNetFile
ForEach ($_ in $OrgNetworks){
if ($_.networktype -eq "Routed"){ createrouted }
elseif ($_.networktype -eq "Direct"){ createdirect }
elseif ($_.networktype -eq "Isolated"){ createisolated }
else { Write-Host "Cannot determine network type!" }
}

# Disconnect from vCloud Director server
Disconnect-CIServer $CIServer -Confirm:$false

The script can be run as follows: .\Rebuild-OrgNetworks.ps1 -s vcloud.vsential.lab -o 1002-Org -v 1002-VDC -f OrgNetworks.csv

At a future date I hope to add the ability to recreate any services associated with the networks and possibly the ability to create Edge Gateway devices for you, if needed.  If you have any suggestions, comments, and/or questions then sound off in the comments and I will do my best to help you out.  I hope to see many different iterations of this from the community and if you modify this then please let me know, I would love to see what you did!

And one more thing, like my last post, a lot of the information I used to build this was built on information that Jake Robinson (GeekAfterFive.com) posted about creating vApp networks in vCD 5.1, so definitely thanks to him for his awesomeness and guidance!  So with that said, I hope that you find this useful and happy scripting!

Leave a Comment

You May Also Enjoy

A Couple of Things

3 minute read

So I know that it has been quite a while since I have posted anything. Needless to say that we all have things that come up in our lives that keep us from d...

Change is Good

2 minute read

Life belongs to the living, and he who lives must be prepared for changes. – Johann Wolfgang von Goethe

Export vRealize Automation 7 Blueprints

4 minute read

Now that people are starting to build out vRealize Automation 7 in some environments, we find that we need to use some of the new features, or at least, we w...

New Look…Fresh Feel

less than 1 minute read

I am not quite sure why but I decided to change the look of my site again. I know that I was not on the old design for long but I just felt it was lacking. ...