lib/private/switch.ps1
|
<#
.SYNOPSIS Returns the name of the Management Switch to use for this lab. .DESCRIPTION Each lab has a unique private management switch created for it. All Virtual Machines in the Lab are connected to the switch. This function returns the name of this swtich for the provided lab configuration. .PARAMETER Lab Contains the Lab object that was produced by the Get-Lab cmdlet. .EXAMPLE $Lab = Get-Lab -ConfigPath c:\mylab\config.xml $ManagementSwtich = GetManagementSwitchName -Lab $Lab Returns the Management Switch for the Lab c:\mylab\config.xml. .OUTPUTS A management switch name. #> function GetManagementSwitchName { [CmdLetBinding()] param ( [Parameter(Mandatory = $true)] $Lab ) [System.String] $LabId = $Lab.labbuilderconfig.settings.labid if (-not $LabId) { $LabId = $Lab.labbuilderconfig.name } # if $ManagementSwitchName = ('{0}Lab Management' ` -f $LabId) return $ManagementSwitchName } # GetManagementSwitchName <# .SYNOPSIS Ensures that the Management OS virtual adapter is attached to a Virtual Switch. .DESCRIPTION This function is used to add or update the specified virtual network adapter that is used by the Management OS to connect to the specifed virtual switch. .PARAMETER Name Contains the name of the virtual network adapter to add. .PARAMETER SwitchName Contains the name of the virtual switch to connect this adapter to. .PARAMETER StaticMacAddress This optional parameter contains the static MAC address to assign to the virtual network adapter. .PARAMETER VlanId This optional parameter contains the VLan Id to assign to this network adapter. .EXAMPLE UpdateSwitchManagementAdapter -Name 'Domain Nat SMB' -SwitchName 'Domain Nat' -VlanId 25 .OUTPUTS None. #> function UpdateSwitchManagementAdapter { [CmdLetBinding()] param ( [Parameter(Mandatory = $true)] [System.String] $Name, [Parameter(Mandatory = $true)] [System.String] $SwitchName, [System.String] $StaticMacAddress, $VLanId ) # Determine if we should set the MAC address and VLan Id [Boolean] $SetVlanId = ($PSBoundParameters.ContainsKey('VLanId')) [Boolean] $SetMacAddress = ($PSBoundParameters.ContainsKey('StaticMacAddress')) # Remove VLanId Parameter so this can be splatted $null = $PSBoundParameters.Remove('VLanId') $null = $PSBoundParameters.Remove('StaticMacAddress') $Adapter = Get-VMNetworkAdapter ` -ManagementOS ` @PSBoundParameters ` -ErrorAction SilentlyContinue if (-not $Adapter) { # Adapter does not exist so add it if ($SetMacAddress) { # For a management adapter a Static MAC address can only be assigned # at creation time. if (-not ([System.String]::IsNullOrEmpty($StaticMacAddress))) { $PSBoundParameters.Add('StaticMacAddress', $StaticMacAddress) } # if } # If $Adapter = Add-VMNetworkAdapter ` -ManagementOS ` @PSBoundParameters ` -Passthru } else { # The MAC Address for an existing Management Adapter can not be changed # This shouldn't ever happen unless the configuration is changed. # Not sure of the solution to this problem. } # if # Set or clear the VLanId if ($SetVlanId) { if ([System.String]::IsNullOrEmpty($VLanId)) { $VlanSplat = @{ Untagged = $True } } else { $VlanSplat = @{ Access = $True VlanId = $VlanId } } # if $null = $Adapter | Set-VMNetworkAdapterVlan ` @VlanSplat ` -ErrorAction Stop } # if } # UpdateSwitchManagementAdapter |