Get-CMDuplicateHardwareIdMacAddress
View duplicate hardware identifiers by MAC address.
Syntax
Get-CMDuplicateHardwareIdMacAddress
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Get-CMDuplicateHardwareIdMacAddress
-Id <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Description
Use this cmdlet to view duplicate hardware identifiers by network MAC address. Configuration Manager ignores these MAC addresses for PXE boot and client registration. For more information, see Manage duplicate hardware identifiers.
Note
Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>
. For more information, see getting started.
Examples
Example 1: View all MAC addresses
This example displays all duplicate addresses from the site.
Get-CMDuplicateHardwareIdMacAddress | Select-Object MACAddress
Example 2: Test for a specific MAC address
The following example script checks if a specific address is found, and then writes a message based on the result.
$mac = "01:23:45:67:89:AB"
if ( Get-CMDuplicateHardwareIdMacAddress -Id $mac ) {
Write-Host $mac "exists in the site"
} else {
Write-Host $mac "doesn't exist!"
}
Parameters
-DisableWildcardHandling
This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Specify a duplicate hardware MAC address. The format of this value uses colon (:
) delimiters, for example, "01:23:45:67:89:AB"
.
Type: | String |
Aliases: | DuplicateId, DuplicateHardwareId |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
None
Outputs
IResultObject[]
IResultObject
Notes
This cmdlet returns the SMS_CommonMacAddresses WMI class object.