added fn Find-VNVMWithDuplicateMACAddress

Author: mtboren

ToDo.md

@@ -10,7 +10,14 @@
   - support searching by guest DNS name (also using `VMware.Vim.SearchIndex`, via the `FindAllByDnsName` method)
 - update function `Get-VNVMByVirtualPortGroup` to take a standard- or distributed virtual portgroup as a parameter (and, from pipeline)
 - update function `Copy-VNVIRole` to take SourceVIRole as VIRole object, and to accept it from pipeline
-- update function `Get-VNVMEVCInfo` to take Cluster object from pipeline
 - update function `Get-VNUplinkNicForVM` to give more meaningful VDSwitch identification (currently returns something to the effect of `DvsPortset-1` for the VDSwitch name)
-- add function for finding duplicate VM NIC MAC address in vCenter
 - ?add function for changing VM boot order
+- investigate using a PropertyCollector to more quickly retrieve VM network adapter MAC addresses for function `Find-VNVMWithDuplicateMACAddress`
+
+### Doing
+
+\[feat_UpdateCmdlets]:
+- update function `Get-VNVMEVCInfo` to take Cluster object from pipeline
+
+done:
+- added function `Find-VNVMWithDuplicateMACAddress` for finding duplicate VM NIC MAC address in vCenter

makeModule.ps1

@@ -10,7 +10,7 @@ $hshModManifestParams = @{
 	#DefaultCommandPrefix = ""
 	#FormatsToProcess = "SomeModule.format.ps1xml"
 	ModuleToProcess = "vNuggletsUtilityMod.psm1"
-	ModuleVersion = "1.0.0"
+	ModuleVersion = "1.1.0"
 	## scripts (.ps1) that are listed in the NestedModules key are run in the module's session state, not in the caller's session state. To run a script in the caller's session state, list the script file name in the value of the ScriptsToProcess key in the manifest
 	NestedModules = @("vNuggletsUtilityMod_functions.ps1", "vNugglets_SupportingFunctions.ps1")
 	PowerShellVersion = [System.Version]"4.0"

vNugglets.Utility/vNugglets.Utility.psd1

@@ -3,7 +3,7 @@
 #
 # Generated by: Matt Boren
 #
-# Generated on: 12/2/2016
+# Generated on: 12/6/2016
 #
 
 @{
@@ -12,10 +12,10 @@
 RootModule = 'vNuggletsUtilityMod.psm1'
 
 # Version number of this module.
-ModuleVersion = '1.0.0'
+ModuleVersion = '1.1.0'
 
 # ID used to uniquely identify this module
-GUID = 'c07f8992-e2c1-42d5-a7a3-49dbd2cdfd20'
+GUID = 'a22ca8fe-3739-463f-b8dd-4d5d2c9ffec4'
 
 # Author of this module
 Author = 'Matt Boren'

vNugglets.Utility/vNuggletsUtilityMod.psm1

@@ -15,7 +15,7 @@ $arrAliasNamesToExport = $hshNewAliasInfo.GetEnumerator() | Foreach-Object {
 
 ## export these items for use by consumer
 $hshModuleMemberParams = @{
-	Function = Write-Output Connect-VNVIServer, Copy-VNVIRole, Disconnect-VNVIServer,
+	Function = Write-Output Connect-VNVIServer, Copy-VNVIRole, Disconnect-VNVIServer, Find-VNVMWithDuplicateMACAddress,
 		Get-VNNetworkClusterInfo, Get-VNUplinkNicForVM, Get-VNVMByAddress, Get-VNVMByRDM, Get-VNVMByVirtualPortGroup, Get-VNVMDiskAndRDM, Get-VNVMEVCInfo,
 		Get-VNVMHostBrokenUplink, Get-VNVMHostFirmwareInfo, Get-VNVMHostHBAWWN, Get-VNVMHostLogicalVolumeInfo, Get-VNVMHostNICFirmwareAndDriverInfo,
 		Invoke-VNEvacuateDatastore, Move-VNTemplateFromVMHost, Update-VNTitleBarForPowerCLI

vNugglets.Utility/vNuggletsUtilityMod_functions.ps1

@@ -1,3 +1,66 @@
+function Find-VNVMWithDuplicateMACAddress {
+<#  .Description
+    Get information about the VM(s) that have a network adapter whose MAC address is a duplicate of another network adapter in the vCenter(s) to which this PowerCLI session is connected
+
+    .Synopsis
+    Get information about duplicate MAC addresses
+
+    .Example
+    Find-VNVMWithDuplicateMACAddress
+    VMName                DuplicatedMAC         MoRef                                                Count
+    ------                -------------         -----                                                -----
+    {myVM03, oldVM322}    00:50:56:3F:FF:FF     {VirtualMachine-vm-16277, VirtualMachine-vm-109}         2
+
+    Find VMs with network adapters whose MAC address is the same, and return a bit of info about them
+
+    .Example
+    Find-VNVMWithDuplicateMACAddress
+    VMName     DuplicatedMAC         MoRef                       Count
+    ------     -------------         -----                       -----
+    myVM21     00:50:56:00:00:09     VirtualMachine-vm-16277         2
+
+    Find VM (just one, apparently, in this vCenter) with network adapters whose MAC address is the same -- in this case, the VM has at least two network adapters, both of which have the same MAC address
+
+    .Link
+    http://vNugglets.com
+
+    .Outputs
+    System.Management.Automation.PSCustomObject
+#>
+    [CmdletBinding()]
+    [OutputType([System.Management.Automation.PSCustomObject])]
+    Param () ## end param
+
+    process {
+        ## get VirtualMachine .NET views where the items is not marked as a Template
+        $colDevMacAddrInfo = `
+        Get-View -ViewType VirtualMachine -Property Name,Config.Hardware.Device -Filter @{"Config.Template" = "False"} | Foreach-Object {
+           $viewThisVM = $_
+           $_.Config.Hardware.Device | Where-Object {$_ -is [VMware.Vim.VirtualEthernetCard]} | Foreach-Object {
+               New-Object -Type PSObject -Property @{VMName = $viewThisVM.Name; MacAddr = $_.MacAddress; MoRef = $viewThisVM.MoRef}
+           } ## end foreach-object
+        } ## end foreach-object
+
+        ## get the non-unique MAC addresses (if any),
+        $arrDuplicatedMAC_GroupInfo = $colDevMacAddrInfo | Group-Object MacAddr | Where-Object {$_.count -gt 1}
+
+        ## for each duplicated MAC, return an object with the given properties
+        if ($null -ne $arrDuplicatedMAC_GroupInfo) {
+            $arrDuplicatedMAC_GroupInfo | Foreach-Object {
+                New-Object -Type PSObject -Property ([ordered]@{
+                    VMName = $_.Group | Foreach-Object {$_.VMName} | Select-Object -Unique
+                    DuplicatedMAC = $_.Name
+                    MoRef = $_.Group | Foreach-Object {$_.MoRef} | Select-Object -Unique
+                    Count = $_.Count
+                }) ## end new-object
+            } ## end foreach-object
+        } ## end if
+        else {Write-Verbose "no duplicate MAC addresses found on non-template VMs"}
+    } ## end process
+} ## end function
+
+
+
 function Get-VNNetworkClusterInfo {
 <#  .Description
     Get information about the VMware HA Cluster(s) in which the given virtual network (virtual portgroup) is defined. May 2015