GetItems.ps1
|
function Get-VNVDTrafficFilterPolicyConfig { <# .Description Get the VDTrafficFilterPolicy configuration for the given VDPortgroup(s) from VDSwitch(es) .Example Get-VDSwitch -Name myVDSw0 | Get-VDPortGroup -Name myVDPG0 | Get-VNVDTrafficFilterPolicyConfig Get the TrafficFilter policy config for the given VDPortgroup .Outputs VNVDTrafficFilterPolicyConfig with properties with at least VMware.Vim.DvsTrafficFilterConfig and VMware.Vim.DistributedVirtualPortgroup for the TrafficFilter policy config #> [CmdletBinding()] [OutputType([VNVDTrafficFilterPolicyConfig])] param ( ## The virtual distributed portgroup for which to get the traffic filtering and marking policy configuration [parameter(Mandatory=$true, ValueFromPipeline=$true)][VMware.VimAutomation.Vds.Types.V1.VmwareVDPortgroup[]]$VDPortgroup ) ## end param process { $VDPortgroup | Foreach-Object { $oThisVDPG = $_ New-Object -Type VNVDTrafficFilterPolicyConfig -Property @{ TrafficFilterPolicyConfig = $oThisVDPG.ExtensionData.Config.DefaultPortConfig.FilterPolicy.FilterConfig VDPortgroupView = $oThisVDPG.ExtensionData } ## end new-object } ## end foreach-object } ## end process } ## end fn function Get-VNVDTrafficRuleSet { <# .Description Get the DvsTrafficRuleset for the given VDTrafficFilterPolicy configuration from VDPortgroup(s), or from VDPortgroup(s) directly .Example Get-VDSwitch -Name myVDSw0 | Get-VDPortGroup -Name myVDPG0 | Get-VNVDTrafficFilterPolicyConfig | Get-VNVDTrafficRuleSet Get the traffic ruleset from the TrafficFilterPolicyConfig object of a given vDPG. Can also get the ruleset from just the vDPG, but this "from TrafficFilterPolicyConfig" method is to help show the relationship between the vDPG, the TrafficFilterPolicyConfig, and the TrafficRuleset .Example Get-VDSwitch -Name myVDSw0 | Get-VDPortGroup -Name myVDPG0 | Get-VNVDTrafficRuleSet Get the traffic ruleset directly from the given vDPG .Outputs VNVDTrafficRuleSet with properties with at least VMware.Vim.DvsTrafficRuleset and VMware.Vim.DistributedVirtualPortgroup for the Traffic rule set #> [CmdletBinding(DefaultParameterSetName="ByTrafficFilterPolicyConfig")] [OutputType([VNVDTrafficRuleSet])] param ( ## The traffic filter policy config of the virtual distributed portgroup for which to get the traffic ruleset [parameter(Mandatory=$true, ValueFromPipeline=$true, ParameterSetName="ByTrafficFilterPolicyConfig")][VNVDTrafficFilterPolicyConfig[]]$TrafficFilterPolicyConfig, ## The virtual distributed portgroup for which to get the traffic ruleset [parameter(Mandatory=$true, ValueFromPipeline=$true, ParameterSetName="ByVDPortGroup")][VMware.VimAutomation.Vds.Types.V1.VmwareVDPortgroup[]]$VDPortgroup, ## The View object for the virtual distributed portgroup for which to get the traffic ruleset [parameter(Mandatory=$true, ValueFromPipeline=$true, ParameterSetName="ByVDPortGroupView")][VMware.Vim.DistributedVirtualPortgroup[]]$VDPortgroupView ) ## end param process { Switch ($PSCmdlet.ParameterSetName) { "ByTrafficFilterPolicyConfig" { $TrafficFilterPolicyConfig | Foreach-Object { New-Object -Type VNVDTrafficRuleSet -Property @{ TrafficRuleset = $_.TrafficFilterPolicyConfig.TrafficRuleset TrafficRulesetEnabled = $_.TrafficFilterPolicyConfig.TrafficRuleset.Enabled NumTrafficRule = ($_.TrafficFilterPolicyConfig.TrafficRuleset.Rules | Measure-Object).Count VDPortgroupView = $_.VDPortgroupView } ## end new-object } ## end foreach-object break } ## end case {"ByVDPortGroup", "ByVDPortGroupView" -contains $_} { ## get the View objects over which to iterate (either the .ExtensionData) $(if ($PSCmdlet.ParameterSetName -eq "ByVDPortGroup") {$VDPortgroup | Foreach-Object {$_.ExtensionData}} else {$VDPortgroupView}) | Foreach-Object { ## update the ViewData for this vDPG, just to be sure that all is current $oThisVDPGView = $_; $oThisVDPGView.UpdateViewData("Config") $oThisVDPGView.Config.DefaultPortConfig.FilterPolicy.FilterConfig | Foreach-Object { New-Object -Type VNVDTrafficRuleSet -Property @{ TrafficRuleset = $_.TrafficRuleset TrafficRulesetEnabled = $_.TrafficRuleset.Enabled NumTrafficRule = ($_.TrafficRuleset.Rules | Measure-Object).Count VDPortgroupView = $oThisVDPGView } ## end new-object } ## end foreach-object } ## end foreach-object } ## end case } ## end switch } ## end process } ## end function function Get-VNVDTrafficRule { <# .Description Get the VDTrafficRule for the TrafficRuleset from the given VDTrafficFilterPolicy configuration from VDPortgroup(s) .Example Get-VDSwitch -Name myVDSw0 | Get-VDPortGroup -Name myVDPG0 | Get-VNVDTrafficFilterPolicyConfig | Get-VNVDTrafficRuleSet | Get-VNVDTrafficRule Get the traffic rules from the TrafficeRuleset, which was gotten from the vDPG's TrafficFilterPolicyConfig .Example Get-VDSwitch -Name myVDSw0 | Get-VDPortGroup -Name myVDPG0 | Get-VNVDTrafficFilterPolicyConfig | Get-VNVDTrafficRuleSet | Get-VNVDTrafficRule myTestRule* Get traffic rules whose name is like "myTestRule*" .Outputs VNVDTrafficRule with at least properties for VMware.Vim.DvsTrafficRule and VMware.Vim.DistributedVirtualPortgroup for the Traffic rule set rule #> [CmdletBinding(DefaultParameterSetName="Default")] [OutputType([VNVDTrafficRule])] param ( ## The name(s) of the Traffic Rule(s) to return (accepts wildcards). If -Name or -LiteralName not specified, will return all Traffic Rules for the given traffic rule set [parameter(ParameterSetName="ByName", Position=0)][String[]]$Name, ## The name(s) of the Traffic Rule(s) to return (exact match only, no wildcarding employed). If -Name or -LiteralName not specified, will return all Traffic Rules for the given traffic rule set [parameter(ParameterSetName="ByLiteralName")][String[]]$LiteralName, ## The traffic ruleset from the traffic filter policy of the virtual distributed portgroup for which to get the traffic rule(s) [parameter(Mandatory=$true, ValueFromPipeline=$true)][VNVDTrafficRuleSet[]]$TrafficRuleset ) ## end param process { $TrafficRuleset | Foreach-Object { $oThisTrafficRuleset = $_ $arrRulesOfInterest = ## if -Name was passed, only return rules whose descriptions are like the given name value(s) if ($PSBoundParameters.ContainsKey("Name")) {$_.TrafficRuleset.Rules | Where-Object {$oThisDescription = $_.Description; ($Name | Foreach-Object {$oThisDescription -like $_}) -contains $true}} elseif ($PSBoundParameters.ContainsKey("LiteralName")) {$_.TrafficRuleset.Rules | Where-Object {$LiteralName -contains $_.Description}} else {$_.TrafficRuleset.Rules | Where-Object {$null -ne $_}} $arrRulesOfInterest | Foreach-Object { $oThisTrafficRule = $_ New-Object -Type VNVDTrafficRule -Property @{ Name = $oThisTrafficRule.Description TrafficRule = $oThisTrafficRule VDPortgroupView = $oThisTrafficRuleset.VDPortgroupView VNVDTrafficRuleSet = $oThisTrafficRuleset } ## end new-object } ## end foreach-object } ## end foreach-object } ## end process } ## end function function Get-VNVDTrafficRuleQualifier { <# .Description Get the VDTrafficRule Qualifier for the TrafficRule from the given VDTrafficFilterPolicy configuration from VDPortgroup(s) .Example Get-VDSwitch -Name myVDSw0 | Get-VDPortGroup -Name myVDPG0 | Get-VNVDTrafficFilterPolicyConfig | Get-VNVDTrafficRule | Get-VNVDTrafficRuleQualifier Get the traffic rules qualifiers from the traffic rules from the TrafficeRuleset property of the TrafficFilterPolicyConfig .Outputs VMware.Vim.DvsNetworkRuleQualifier #> [CmdletBinding()] [OutputType([VMware.Vim.DvsNetworkRuleQualifier])] param ( ## The traffic ruleset rule from the traffic filter policy of the virtual distributed portgroup for which to get the traffic rule qualifier(s) [parameter(Mandatory=$true, ValueFromPipeline=$true, ParameterSetName="ByTrafficRule")][VNVDTrafficRule[]]$TrafficRule ) ## end param process { $TrafficRule | Foreach-Object { $_.TrafficRule.Qualifier | Where-Object {$null -ne $_} | Foreach-Object { ## get the qualifier TypeName short name (like, if TypeName is "VMware.Vim.DvsIpNetworkRuleQualifier", this will be "DvsIpNetworkRuleQualifier") $strQualifierTypeShortname = ($_ | Get-Member | Select-Object -First 1).TypeName.Split(".") | Select-Object -Last 1 ## the properties to select for this Qualifier object $arrPropertyForSelectObject = @{n="QualifierType"; e={$strQualifierTypeShortname}}, "*" ## if the Qualifier object is of type VMware.Vim.DvsSystemTrafficNetworkRuleQualifier, essentially "expand" the TypeOfSystemTraffic.Value property to be one level up in the return object if ($strQualifierTypeShortname -eq "DvsSystemTrafficNetworkRuleQualifier") {$arrPropertyForSelectObject += @{n="TypeOfSystemTraffic_Name"; e={$_.TypeOfSystemTraffic.Value}}} $_ | Select-Object -Property $arrPropertyForSelectObject } ## end foreach-object } ## end foreach-object } ## end process } ## end function function Get-VNVDTrafficRuleAction { <# .Description Get the VDTrafficRule Action for the TrafficRule from the given VDTrafficFilterPolicy configuration from VDPortgroup(s) .Example Get-VDSwitch -Name myVDSw0 | Get-VDPortGroup -Name myVDPG0 | Get-VNVDTrafficFilterPolicyConfig | Get-VNVDTrafficRule | Get-VNVDTrafficRuleAction Get the traffic rules action from the traffic rules from the TrafficeRuleset property of the TrafficFilterPolicyConfig .Outputs VMware.Vim.DvsNetworkRuleAction #> [CmdletBinding()] [OutputType([VMware.Vim.DvsNetworkRuleAction])] param ( ## The traffic ruleset rule from the traffic filter policy of the virtual distributed portgroup for which to get the traffic rule action [parameter(Mandatory=$true, ValueFromPipeline=$true, ParameterSetName="ByTrafficRule")][VNVDTrafficRule[]]$TrafficRule ) ## end param process { $TrafficRule | Foreach-Object { $_.TrafficRule.Action } ## end foreach-object } ## end process } ## end function function Get-VNVSwitchByVMHostNetworkAdapter { <# .Description Get the virtual switch (standard or distributed) with which the given VMHostNetworkAdapter physical NIC is associated, if any. .Example Get-VMHost myVMHost0.dom.com | Get-VMHostNetworkAdapter -Name vmnic2 | Get-VNVSwitchByVMHostNetworkAdapter Get the vSwitch with which VMNIC2 on myVMHost0.dom.com is associated .Outputs Virtual standard- or distributed switch with which given physical VMHost network adapter is associated, if any #> [CmdletBinding()] param( ## The VMHostNetworkAdapter (physical NIC) for which to get the vSwitch [parameter(Mandatory=$true, ValueFromPipeline=$true)][VMware.VimAutomation.Types.Host.NIC.PhysicalNic[]]$VMHostNetworkAdapter ) ## end param process { $VMHostNetworkAdapter | Foreach-Object { $oThisVMHostNetworkAdapter = $_ if ($oAssociatedVSwitch = $oThisVMHostNetworkAdapter.VMHost.ExtensionData.Config.Network.Vswitch, $oThisVMHostNetworkAdapter.VMHost.ExtensionData.Config.Network.ProxySwitch | Foreach-Object {$_} | Where-Object {$_.Pnic -contains $oThisVMHostNetworkAdapter.Id}) { switch ($oAssociatedVSwitch) { ## vSS {$_ -is [VMware.Vim.HostVirtualSwitch]} { $oThisVMHostNetworkAdapter.VMHost | Get-VirtualSwitch -Standard -Name $oAssociatedVSwitch.Name break } ## end case ## vDSwitch {$_ -is [VMware.Vim.HostProxySwitch]} { $oThisVMHostNetworkAdapter.VMHost | Get-VDSwitch -Name $oAssociatedVSwitch.DvsName break } ## end case default {Write-Warning "vSwitch not of expected type of either [VMware.Vim.HostVirtualSwitch] or [VMware.Vim.HostProxySwitch]. What kind of vSwitch is it? $_"} } ## end switch } ## end if else {Write-Verbose "No vSwitch associated with VMNIC '$($oThisVMHostNetworkAdapter.Name)' found on VMHost '$($oThisVMHostNetworkAdapter.VMHost.Name)'"} } ## end Foreach-Object } ## end process } ## end fn |