diff --git a/CHANGELOG.md b/CHANGELOG.md index 47fe5f28..e1f237eb 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -26,6 +26,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - Updated build to use `Sampler.GitHubTasks` - Fixes [Issue #489](https://github.com/dsccommunity/NetworkingDsc/issues/489). - Added support for publishing code coverage to `CodeCov.io` and Azure Pipelines - Fixes [Issue #491](https://github.com/dsccommunity/NetworkingDsc/issues/491). +- Allow configuration of hidden network adapters. ## [8.2.0] - 2020-10-16 diff --git a/source/DSCResources/DSC_DefaultGatewayAddress/DSC_DefaultGatewayAddress.psm1 b/source/DSCResources/DSC_DefaultGatewayAddress/DSC_DefaultGatewayAddress.psm1 index d1034729..142c3110 100644 --- a/source/DSCResources/DSC_DefaultGatewayAddress/DSC_DefaultGatewayAddress.psm1 +++ b/source/DSCResources/DSC_DefaultGatewayAddress/DSC_DefaultGatewayAddress.psm1 @@ -292,7 +292,7 @@ function Assert-ResourceProperty $Address ) - if (-not (Get-NetAdapter | Where-Object -Property Name -EQ $InterfaceAlias )) + if (-not (Find-NetworkAdapter -Name $InterfaceAlias )) { New-InvalidOperationException ` -Message ($script:localizedData.InterfaceNotAvailableError -f $InterfaceAlias) diff --git a/source/DSCResources/DSC_DnsConnectionSuffix/DSC_DnsConnectionSuffix.psm1 b/source/DSCResources/DSC_DnsConnectionSuffix/DSC_DnsConnectionSuffix.psm1 index cb6aad4f..f89526b2 100644 --- a/source/DSCResources/DSC_DnsConnectionSuffix/DSC_DnsConnectionSuffix.psm1 +++ b/source/DSCResources/DSC_DnsConnectionSuffix/DSC_DnsConnectionSuffix.psm1 @@ -60,7 +60,9 @@ function Get-TargetResource $Ensure = 'Present' ) - $dnsClient = Get-DnsClient -InterfaceAlias $InterfaceAlias -ErrorAction SilentlyContinue + $dnsClient = Get-DnsClient ` + -InterfaceAlias $InterfaceAlias ` + -ErrorAction SilentlyContinue $targetResource = @{ InterfaceAlias = $dnsClient.InterfaceAlias diff --git a/source/DSCResources/DSC_FirewallProfile/DSC_FirewallProfile.psm1 b/source/DSCResources/DSC_FirewallProfile/DSC_FirewallProfile.psm1 index 9e0a3c79..debc49d5 100644 --- a/source/DSCResources/DSC_FirewallProfile/DSC_FirewallProfile.psm1 +++ b/source/DSCResources/DSC_FirewallProfile/DSC_FirewallProfile.psm1 @@ -46,7 +46,8 @@ function Get-TargetResource ) -join '' ) # Get the current Dns Client Global Settings - $netFirewallProfile = Get-NetFirewallProfile -Name $Name ` + $netFirewallProfile = Get-NetFirewallProfile ` + -Name $Name ` -ErrorAction Stop # Generate the return object. @@ -231,7 +232,8 @@ function Set-TargetResource ) -join '' ) # Get the current Firewall Profile Settings - $netFirewallProfile = Get-NetFirewallProfile -Name $Name ` + $netFirewallProfile = Get-NetFirewallProfile ` + -Name $Name ` -ErrorAction Stop # Generate a list of parameters that will need to be changed. @@ -243,7 +245,10 @@ function Set-TargetResource $parameterNewValue = (Get-Variable -Name ($parameter.name)).Value if ($PSBoundParameters.ContainsKey($parameter.Name) ` - -and (Compare-Object -ReferenceObject $parameterSourceValue -DifferenceObject $parameterNewValue -SyncWindow 0)) + -and (Compare-Object ` + -ReferenceObject $parameterSourceValue ` + -DifferenceObject $parameterNewValue ` + -SyncWindow 0)) { $changeParameters += @{ $($parameter.name) = $parameterNewValue @@ -442,7 +447,8 @@ function Test-TargetResource $desiredConfigurationMatch = $true # Get the current Dns Client Global Settings - $netFirewallProfile = Get-NetFirewallProfile -Name $Name ` + $netFirewallProfile = Get-NetFirewallProfile ` + -Name $Name ` -ErrorAction Stop # Check each parameter diff --git a/source/DSCResources/DSC_IPAddress/DSC_IPAddress.psm1 b/source/DSCResources/DSC_IPAddress/DSC_IPAddress.psm1 index a715f64c..18bd8dc1 100644 --- a/source/DSCResources/DSC_IPAddress/DSC_IPAddress.psm1 +++ b/source/DSCResources/DSC_IPAddress/DSC_IPAddress.psm1 @@ -228,7 +228,8 @@ function Set-TargetResource try { # Apply the specified IP configuration - New-NetIPAddress @newNetIPAddressParameters -ErrorAction Stop + New-NetIPAddress @newNetIPAddressParameters ` + -ErrorAction Stop } catch [Microsoft.Management.Infrastructure.CimException] { @@ -240,7 +241,8 @@ function Set-TargetResource Setting New-NetIPaddress will throw [Microsoft.Management.Infrastructure.CimException] if the IP address is already set. Need to check to make sure the IP is set on correct interface #> - $verifyNetIPAddressAdapter = Get-NetIPAddress @verifyNetIPAddressAdapterParam -ErrorAction SilentlyContinue + $verifyNetIPAddressAdapter = Get-NetIPAddress @verifyNetIPAddressAdapterParam ` + -ErrorAction SilentlyContinue if ($verifyNetIPAddressAdapter.InterfaceAlias -eq $InterfaceAlias) { @@ -343,7 +345,9 @@ function Test-TargetResource } } # while - $ipAddressObject = Get-IPAddressPrefix -IPAddress $IPAddress -AddressFamily $AddressFamily + $ipAddressObject = Get-IPAddressPrefix ` + -IPAddress $IPAddress ` + -AddressFamily $AddressFamily # Test if the IP Address passed is present foreach ($singleIP in $ipAddressObject) @@ -480,7 +484,9 @@ function Assert-ResourceProperty { $singleIP = ($singleIPAddress -split '/')[0] - Assert-IPAddress -Address $singleIP -AddressFamily $AddressFamily + Assert-IPAddress ` + -Address $singleIP ` + -AddressFamily $AddressFamily } foreach ($prefixLength in $prefixLengthArray) diff --git a/source/DSCResources/DSC_IPAddressOption/DSC_IPAddressOption.psm1 b/source/DSCResources/DSC_IPAddressOption/DSC_IPAddressOption.psm1 index 8c90074e..06203372 100644 --- a/source/DSCResources/DSC_IPAddressOption/DSC_IPAddressOption.psm1 +++ b/source/DSCResources/DSC_IPAddressOption/DSC_IPAddressOption.psm1 @@ -83,7 +83,9 @@ function Set-TargetResource if ($currentConfig.SkipAsSource -ne $SkipAsSource) { - Set-NetIPAddress -IPAddress $IPAddress -SkipAsSource $SkipAsSource + Set-NetIPAddress ` + -IPAddress $IPAddress ` + -SkipAsSource $SkipAsSource } } diff --git a/source/DSCResources/DSC_NetAdapterAdvancedProperty/DSC_NetAdapterAdvancedProperty.psm1 b/source/DSCResources/DSC_NetAdapterAdvancedProperty/DSC_NetAdapterAdvancedProperty.psm1 index b9034af5..a4672c3d 100644 --- a/source/DSCResources/DSC_NetAdapterAdvancedProperty/DSC_NetAdapterAdvancedProperty.psm1 +++ b/source/DSCResources/DSC_NetAdapterAdvancedProperty/DSC_NetAdapterAdvancedProperty.psm1 @@ -51,6 +51,7 @@ function Get-TargetResource { $netAdapterAdvancedProperty = Get-NetAdapterAdvancedProperty ` -Name $networkAdapterName ` + -IncludeHidden:$true ` -RegistryKeyword $RegistryKeyword ` -ErrorAction Stop } @@ -118,6 +119,7 @@ function Set-TargetResource { $netAdapterAdvancedProperty = Get-NetAdapterAdvancedProperty ` -Name $networkAdapterName ` + -IncludeHidden:$true ` -RegistryKeyword $RegistryKeyword ` -ErrorAction Stop } @@ -146,6 +148,7 @@ function Set-TargetResource Set-NetAdapterAdvancedProperty ` -RegistryValue $RegistryValue ` -Name $networkAdapterName ` + -IncludeHidden:$true ` -RegistryKeyword $RegistryKeyword } } @@ -192,6 +195,7 @@ function Test-TargetResource { $netAdapterAdvancedProperty = Get-NetAdapterAdvancedProperty ` -Name $networkAdapterName ` + -IncludeHidden:$true ` -RegistryKeyword $RegistryKeyword ` -ErrorAction Stop } diff --git a/source/DSCResources/DSC_NetAdapterBinding/DSC_NetAdapterBinding.psm1 b/source/DSCResources/DSC_NetAdapterBinding/DSC_NetAdapterBinding.psm1 index b57d30d4..4defa939 100644 --- a/source/DSCResources/DSC_NetAdapterBinding/DSC_NetAdapterBinding.psm1 +++ b/source/DSCResources/DSC_NetAdapterBinding/DSC_NetAdapterBinding.psm1 @@ -126,7 +126,8 @@ function Set-TargetResource if ($State -eq 'Enabled') { - Enable-NetAdapterBinding @PSBoundParameters + Enable-NetAdapterBinding @PSBoundParameters ` + -IncludeHidden:$true Write-Verbose -Message ( @("$($MyInvocation.MyCommand): " $($script:localizedData.NetAdapterBindingEnabledMessage -f ` @@ -135,7 +136,8 @@ function Set-TargetResource } else { - Disable-NetAdapterBinding @PSBoundParameters + Disable-NetAdapterBinding @PSBoundParameters ` + -IncludeHidden:$true Write-Verbose -Message ( @("$($MyInvocation.MyCommand): " $($script:localizedData.NetAdapterBindingDisabledMessage -f ` @@ -260,7 +262,7 @@ function Get-Binding $State = 'Enabled' ) - if (-not (Get-NetAdapter -Name $InterfaceAlias -ErrorAction SilentlyContinue)) + if (-not (Find-NetworkAdapter -Name $InterfaceAlias -ErrorAction SilentlyContinue)) { New-InvalidArgumentException ` -Message ($script:localizedData.InterfaceNotAvailableError -f $InterfaceAlias) ` @@ -269,6 +271,7 @@ function Get-Binding $binding = Get-NetAdapterBinding ` -InterfaceAlias $InterfaceAlias ` + -IncludeHidden:$true ` -ComponentId $ComponentId ` -ErrorAction Stop diff --git a/source/DSCResources/DSC_NetAdapterLso/DSC_NetAdapterLso.psm1 b/source/DSCResources/DSC_NetAdapterLso/DSC_NetAdapterLso.psm1 index 839e2d38..6dd23a0b 100644 --- a/source/DSCResources/DSC_NetAdapterLso/DSC_NetAdapterLso.psm1 +++ b/source/DSCResources/DSC_NetAdapterLso/DSC_NetAdapterLso.psm1 @@ -50,7 +50,10 @@ function Get-TargetResource try { - $netAdapter = Get-NetAdapterLso -Name $Name -ErrorAction Stop + $netAdapter = Get-NetAdapterLso ` + -Name $Name ` + -IncludeHidden:$true ` + -ErrorAction Stop } catch { @@ -131,7 +134,10 @@ function Set-TargetResource try { - $netAdapter = Get-NetAdapterLso -Name $Name -ErrorAction Stop + $netAdapter = Get-NetAdapterLso ` + -Name $Name ` + -IncludeHidden:$true ` + -ErrorAction Stop } catch { @@ -154,7 +160,10 @@ function Set-TargetResource $Name, $Protocol, $($netAdapter.V1IPv4Enabled.ToString()), $($State.ToString()) ) ) -join '') - Set-NetAdapterLso -Name $Name -V1IPv4Enabled $State + Set-NetAdapterLso ` + -Name $Name ` + -IncludeHidden:$true ` + -V1IPv4Enabled $State } elseif ($Protocol -eq 'IPv4' -and $State -ne $netAdapter.IPv4Enabled) { @@ -164,7 +173,10 @@ function Set-TargetResource $Name, $Protocol, $($netAdapter.IPv4Enabled.ToString()), $($State.ToString()) ) ) -join '') - Set-NetAdapterLso -Name $Name -IPv4Enabled $State + Set-NetAdapterLso ` + -Name $Name ` + -IncludeHidden:$true ` + -IPv4Enabled $State } elseif ($Protocol -eq 'IPv6' -and $State -ne $netAdapter.IPv6Enabled) { @@ -174,7 +186,10 @@ function Set-TargetResource $Name, $Protocol, $($netAdapter.IPv6Enabled.ToString()), $($State.ToString()) ) ) -join '') - Set-NetAdapterLso -Name $Name -IPv6Enabled $State + Set-NetAdapterLso ` + -Name $Name ` + -IncludeHidden:$true ` + -IPv6Enabled $State } } } @@ -219,7 +234,10 @@ function Test-TargetResource try { - $netAdapter = Get-NetAdapterLso -Name $Name -ErrorAction Stop + $netAdapter = Get-NetAdapterLso ` + -Name $Name ` + -IncludeHidden:$true ` + -ErrorAction Stop } catch { diff --git a/source/DSCResources/DSC_NetAdapterName/DSC_NetAdapterName.psm1 b/source/DSCResources/DSC_NetAdapterName/DSC_NetAdapterName.psm1 index cb61f390..165af86c 100644 --- a/source/DSCResources/DSC_NetAdapterName/DSC_NetAdapterName.psm1 +++ b/source/DSCResources/DSC_NetAdapterName/DSC_NetAdapterName.psm1 @@ -33,6 +33,9 @@ $script:localizedData = Get-LocalizedData -DefaultUICulture 'en-US' .PARAMETER InterfaceDescription This is the interface description of the network adapter to find. + .PARAMETER IncludeHidden + This switch indicates the adapter to find may be hidden. + .PARAMETER InterfaceIndex This is the interface index of the network adapter to find. @@ -84,6 +87,10 @@ function Get-TargetResource [System.String] $InterfaceDescription, + [Parameter()] + [System.Boolean] + $IncludeHidden = $false, + [Parameter()] [System.UInt32] $InterfaceIndex, @@ -111,6 +118,7 @@ function Get-TargetResource $adapter = Find-NetworkAdapter ` -Name $NewName ` + -IncludeHidden:$IncludeHidden ` -ErrorAction SilentlyContinue if (-not $adapter) @@ -136,6 +144,7 @@ function Get-TargetResource Status = $adapter.Status MacAddress = $adapter.MacAddress InterfaceDescription = $adapter.InterfaceDescription + IncludeHidden = $IncludeHidden InterfaceIndex = $adapter.InterfaceIndex InterfaceGuid = $adapter.InterfaceGuid DriverDescription = $adapter.DriverDescription @@ -168,6 +177,9 @@ function Get-TargetResource .PARAMETER InterfaceDescription This is the interface description of the network adapter to find. + .PARAMETER IncludeHidden + This switch indicates the adapter to find may be hidden. + .PARAMETER InterfaceIndex This is the interface index of the network adapter to find. @@ -218,6 +230,10 @@ function Set-TargetResource [System.String] $InterfaceDescription, + [Parameter()] + [System.Boolean] + $IncludeHidden = $false, + [Parameter()] [System.UInt32] $InterfaceIndex, @@ -253,7 +269,9 @@ function Set-TargetResource $($script:localizedData.RenamingNetAdapterNameMessage -f $adapter.Name, $NewName) ) -join '') - $adapter | Rename-NetAdapter -NewName $NewName + $adapter | Rename-NetAdapter ` + -IncludeHidden:$IncludeHidden ` + -NewName $NewName Write-Verbose -Message ( @( "$($MyInvocation.MyCommand): " $($script:localizedData.NetAdapterNameRenamedMessage -f $NewName) @@ -283,6 +301,9 @@ function Set-TargetResource .PARAMETER InterfaceDescription This is the interface description of the network adapter to find. + .PARAMETER IncludeHidden + This switch indicates the adapter to find may be hidden. + .PARAMETER InterfaceIndex This is the interface index of the network adapter to find. @@ -334,6 +355,10 @@ function Test-TargetResource [System.String] $InterfaceDescription, + [Parameter()] + [System.Boolean] + $IncludeHidden = $false, + [Parameter()] [System.UInt32] $InterfaceIndex, @@ -364,6 +389,7 @@ function Test-TargetResource # Can an adapter be found with the new name? $adapterWithNewName = Find-NetworkAdapter ` -Name $NewName ` + -IncludeHidden:$IncludeHidden ` -Verbose:$Verbose ` -ErrorAction SilentlyContinue diff --git a/source/DSCResources/DSC_NetAdapterName/DSC_NetAdapterName.schema.mof b/source/DSCResources/DSC_NetAdapterName/DSC_NetAdapterName.schema.mof index aa27f022..05f5d6f5 100644 --- a/source/DSCResources/DSC_NetAdapterName/DSC_NetAdapterName.schema.mof +++ b/source/DSCResources/DSC_NetAdapterName/DSC_NetAdapterName.schema.mof @@ -7,6 +7,7 @@ class DSC_NetAdapterName : OMI_BaseResource [Write, Description("This is the status of the network adapter to find."), ValueMap{"Up", "Disconnected", "Disabled"}, Values{"Up", "Disconnected", "Disabled"}] String Status; [Write, Description("This is the MAC address of the network adapter to find.")] String MacAddress; [Write, Description("This is the interface description of the network adapter to find.")] String InterfaceDescription; + [Write, Description("This switch indicates the adapter to find may be hidden.")] Boolean IncludeHidden; [Write, Description("This is the interface index of the network adapter to find.")] UInt32 InterfaceIndex; [Write, Description("This is the interface GUID of the network adapter to find.")] String InterfaceGuid; [Write, Description("This is the driver description of the network adapter.")] String DriverDescription; diff --git a/source/DSCResources/DSC_NetAdapterRdma/DSC_NetAdapterRdma.psm1 b/source/DSCResources/DSC_NetAdapterRdma/DSC_NetAdapterRdma.psm1 index 26d4c3c1..d5bc6421 100644 --- a/source/DSCResources/DSC_NetAdapterRdma/DSC_NetAdapterRdma.psm1 +++ b/source/DSCResources/DSC_NetAdapterRdma/DSC_NetAdapterRdma.psm1 @@ -37,7 +37,10 @@ function Get-TargetResource { Write-Verbose -Message ($script:localizedData.GetNetAdapterRdmaMessage -f $Name) - $netAdapterRdma = Get-NetAdapterRdma -Name $Name -ErrorAction Stop + $netAdapterRdma = Get-NetAdapterRdma ` + -Name $Name ` + -IncludeHidden:$true ` + -ErrorAction Stop } catch { @@ -85,7 +88,10 @@ function Set-TargetResource { Write-Verbose -Message ($script:localizedData.GetNetAdapterRdmaMessage -f $Name) - $netAdapterRdma = Get-NetAdapterRdma -Name $Name -ErrorAction Stop + $netAdapterRdma = Get-NetAdapterRdma ` + -Name $Name ` + -IncludeHidden:$true ` + -ErrorAction Stop } catch { @@ -101,7 +107,10 @@ function Set-TargetResource { Write-Verbose -Message ($script:localizedData.SetNetAdapterRdmaMessage -f $Name, $Enabled) - Set-NetAdapterRdma -Name $Name -Enabled $Enabled + Set-NetAdapterRdma ` + -Name $Name ` + -IncludeHidden:$true ` + -Enabled $Enabled } } } @@ -137,7 +146,9 @@ function Test-TargetResource { Write-Verbose -Message ($script:localizedData.GetNetAdapterRdmaMessage -f $Name) - $netAdapterRdma = Get-NetAdapterRdma -Name $Name -ErrorAction Stop + $netAdapterRdma = Get-NetAdapterRdma ` + -Name $Name ` + -ErrorAction Stop } catch { diff --git a/source/DSCResources/DSC_NetAdapterRsc/DSC_NetAdapterRsc.psm1 b/source/DSCResources/DSC_NetAdapterRsc/DSC_NetAdapterRsc.psm1 index 4246dc61..bfe8c042 100644 --- a/source/DSCResources/DSC_NetAdapterRsc/DSC_NetAdapterRsc.psm1 +++ b/source/DSCResources/DSC_NetAdapterRsc/DSC_NetAdapterRsc.psm1 @@ -50,7 +50,10 @@ function Get-TargetResource try { - $netAdapter = Get-NetAdapterRsc -Name $Name -ErrorAction Stop + $netAdapter = Get-NetAdapterRsc ` + -Name $Name ` + -IncludeHidden:$true ` + -ErrorAction Stop } catch { @@ -132,7 +135,10 @@ function Set-TargetResource try { - $netAdapter = Get-NetAdapterRsc -Name $Name -ErrorAction Stop + $netAdapter = Get-NetAdapterRsc ` + -Name $Name ` + -IncludeHidden:$true ` + -ErrorAction Stop } catch { @@ -155,7 +161,10 @@ function Set-TargetResource $Name, $Protocol, $($netAdapter.IPv4Enabled.ToString()), $($State.ToString()) ) ) -join '') - Set-NetAdapterRsc -Name $Name -IPv4Enabled $State + Set-NetAdapterRsc ` + -Name $Name ` + -IncludeHidden:$true ` + -IPv4Enabled $State } if ($Protocol -in ('IPv6', 'All') -and $State -ne $netAdapter.IPv6Enabled) { @@ -165,7 +174,10 @@ function Set-TargetResource $Name, $Protocol, $($netAdapter.IPv6Enabled.ToString()), $($State.ToString()) ) ) -join '') - Set-NetAdapterRsc -Name $Name -IPv6Enabled $State + Set-NetAdapterRsc ` + -Name $Name ` + -IncludeHidden:$true ` + -IPv6Enabled $State } } } @@ -210,7 +222,10 @@ function Test-TargetResource try { - $netAdapter = Get-NetAdapterRsc -Name $Name -ErrorAction Stop + $netAdapter = Get-NetAdapterRsc ` + -Name $Name ` + -IncludeHidden:$true ` + -ErrorAction Stop } catch { diff --git a/source/DSCResources/DSC_NetAdapterRss/DSC_NetAdapterRss.psm1 b/source/DSCResources/DSC_NetAdapterRss/DSC_NetAdapterRss.psm1 index 09b43f9d..eb438c02 100644 --- a/source/DSCResources/DSC_NetAdapterRss/DSC_NetAdapterRss.psm1 +++ b/source/DSCResources/DSC_NetAdapterRss/DSC_NetAdapterRss.psm1 @@ -42,7 +42,10 @@ function Get-TargetResource try { - $netAdapter = Get-NetAdapterRss -Name $Name -ErrorAction Stop + $netAdapter = Get-NetAdapterRss ` + -Name $Name ` + -IncludeHidden:$true ` + -ErrorAction Stop } catch { @@ -97,7 +100,10 @@ function Set-TargetResource try { - $netAdapter = Get-NetAdapterRss -Name $Name -ErrorAction Stop + $netAdapter = Get-NetAdapterRss ` + -Name $Name ` + -IncludeHidden:$true ` + -ErrorAction Stop } catch { @@ -120,7 +126,10 @@ function Set-TargetResource $Name, $Enabled, $($netAdapter.Enabled.ToString()), $($Enabled.ToString()) ) ) -join '') - Set-NetAdapterRss -Name $Name -Enabled:$Enabled + Set-NetAdapterRss ` + -Name $Name ` + -IncludeHidden:$true ` + -Enabled:$Enabled } } } @@ -157,7 +166,10 @@ function Test-TargetResource try { - $netAdapter = Get-NetAdapterRss -Name $Name -ErrorAction Stop + $netAdapter = Get-NetAdapterRss ` + -Name $Name ` + -IncludeHidden:$true ` + -ErrorAction Stop } catch { diff --git a/source/DSCResources/DSC_NetAdapterState/DSC_NetAdapterState.psm1 b/source/DSCResources/DSC_NetAdapterState/DSC_NetAdapterState.psm1 index 1f14ea7a..80d916a0 100644 --- a/source/DSCResources/DSC_NetAdapterState/DSC_NetAdapterState.psm1 +++ b/source/DSCResources/DSC_NetAdapterState/DSC_NetAdapterState.psm1 @@ -44,7 +44,9 @@ function Get-TargetResource try { - $netAdapter = Get-NetAdapter -Name $Name -ErrorAction Stop + $netAdapter = Find-NetworkAdapter ` + -Name $Name ` + -ErrorAction Stop } catch { @@ -115,7 +117,9 @@ function Set-TargetResource try { - $netAdapter = Get-NetAdapter -Name $Name -ErrorAction Stop + $netAdapter = Find-NetworkAdapter ` + -Name $Name ` + -ErrorAction Stop } catch { @@ -131,11 +135,18 @@ function Set-TargetResource { if ($State -eq 'Disabled') { - Disable-NetAdapter -Name $Name -Confirm:$false -ErrorAction Stop + Disable-NetAdapter ` + -Name $Name ` + -IncludeHidden:$true ` + -Confirm:$false ` + -ErrorAction Stop } else { - Enable-NetAdapter -Name $Name -ErrorAction Stop + Enable-NetAdapter ` + -Name $Name ` + -IncludeHidden:$true ` + -ErrorAction Stop } } catch diff --git a/source/DSCResources/DSC_NetBios/DSC_NetBios.psm1 b/source/DSCResources/DSC_NetBios/DSC_NetBios.psm1 index 5516aa0d..a0966063 100644 --- a/source/DSCResources/DSC_NetBios/DSC_NetBios.psm1 +++ b/source/DSCResources/DSC_NetBios/DSC_NetBios.psm1 @@ -92,7 +92,9 @@ function Get-TargetResource foreach ($netAdapterItem in $netAdapter) { - $settingResults += Get-NetAdapterNetbiosOptionsFromRegistry -NetworkAdapterGUID $netAdapterItem.GUID -Setting $Setting + $settingResults += Get-NetAdapterNetbiosOptionsFromRegistry ` + -NetworkAdapterGUID $netAdapterItem.GUID ` + -Setting $Setting Write-Verbose -Message ($script:localizedData.CurrentNetBiosSettingMessage -f $netAdapterItem.NetConnectionID, $settingResults[-1]) } @@ -108,7 +110,9 @@ function Get-TargetResource } else { - $Setting = Get-NetAdapterNetbiosOptionsFromRegistry -NetworkAdapterGUID $netAdapter.GUID -Setting $Setting + $Setting = Get-NetAdapterNetbiosOptionsFromRegistry ` + -NetworkAdapterGUID $netAdapter.GUID ` + -Setting $Setting } Write-Verbose -Message ($script:localizedData.CurrentNetBiosSettingMessage -f $InterfaceAlias, $Setting) @@ -167,7 +171,9 @@ function Set-TargetResource { foreach ($netAdapterItem in $netAdapter) { - $currentValue = Get-NetAdapterNetbiosOptionsFromRegistry -NetworkAdapterGUID $netAdapterItem.GUID -Setting $Setting + $currentValue = Get-NetAdapterNetbiosOptionsFromRegistry ` + -NetworkAdapterGUID $netAdapterItem.GUID ` + -Setting $Setting # Only make changes if necessary if ($currentValue -ne $Setting) @@ -178,9 +184,10 @@ function Set-TargetResource -ResultClassName Win32_NetworkAdapterConfiguration ` -ErrorAction Stop - Set-NetAdapterNetbiosOptions -NetworkAdapterObject $netAdapterConfig ` - -InterfaceAlias $netAdapterItem.NetConnectionID ` - -Setting $Setting + Set-NetAdapterNetbiosOptions ` + -NetworkAdapterObject $netAdapterConfig ` + -InterfaceAlias $netAdapterItem.NetConnectionID ` + -Setting $Setting } } } @@ -192,9 +199,10 @@ function Set-TargetResource -ResultClassName Win32_NetworkAdapterConfiguration ` -ErrorAction Stop - Set-NetAdapterNetbiosOptions -NetworkAdapterObject $netAdapterConfig ` - -InterfaceAlias $netAdapter.NetConnectionID ` - -Setting $Setting + Set-NetAdapterNetbiosOptions ` + -NetworkAdapterObject $netAdapterConfig ` + -InterfaceAlias $netAdapter.NetConnectionID ` + -Setting $Setting } } @@ -269,8 +277,9 @@ function Get-NetAdapterNetbiosOptionsFromRegistry $currentErrorActionPreference = $ErrorActionPreference $ErrorActionPreference = 'SilentlyContinue' - $registryNetbiosOptions = Get-ItemPropertyValue -Name 'NetbiosOptions' ` - -Path "$($script:hklmInterfacesPath)\Tcpip_$($NetworkAdapterGUID)" + $registryNetbiosOptions = Get-ItemPropertyValue ` + -Name 'NetbiosOptions' ` + -Path "$($script:hklmInterfacesPath)\Tcpip_$($NetworkAdapterGUID)" $ErrorActionPreference = $currentErrorActionPreference diff --git a/source/DSCResources/DSC_NetBios/DSC_NetBios.schema.mof b/source/DSCResources/DSC_NetBios/DSC_NetBios.schema.mof index c4560067..9574a7ff 100644 --- a/source/DSCResources/DSC_NetBios/DSC_NetBios.schema.mof +++ b/source/DSCResources/DSC_NetBios/DSC_NetBios.schema.mof @@ -1,4 +1,3 @@ - [ClassVersion("1.0.0.0"), FriendlyName("NetBios")] class DSC_NetBios : OMI_BaseResource { diff --git a/source/DSCResources/DSC_NetConnectionProfile/DSC_NetConnectionProfile.psm1 b/source/DSCResources/DSC_NetConnectionProfile/DSC_NetConnectionProfile.psm1 index 9f9144aa..bd409093 100644 --- a/source/DSCResources/DSC_NetConnectionProfile/DSC_NetConnectionProfile.psm1 +++ b/source/DSCResources/DSC_NetConnectionProfile/DSC_NetConnectionProfile.psm1 @@ -32,7 +32,8 @@ function Get-TargetResource $($script:localizedData.GettingNetConnectionProfile) -f $InterfaceAlias ) -join '') - $result = Get-NetConnectionProfile -InterfaceAlias $InterfaceAlias + $result = Get-NetConnectionProfile ` + -InterfaceAlias $InterfaceAlias return @{ InterfaceAlias = $result.InterfaceAlias @@ -136,7 +137,8 @@ function Test-TargetResource Assert-ResourceProperty @PSBoundParameters - $current = Get-TargetResource -InterfaceAlias $InterfaceAlias + $current = Get-TargetResource ` + -InterfaceAlias $InterfaceAlias if (-not [System.String]::IsNullOrEmpty($IPv4Connectivity) -and ` ($IPv4Connectivity -ne $current.IPv4Connectivity)) @@ -214,7 +216,7 @@ function Assert-ResourceProperty $NetworkCategory ) - if (-not (Get-NetAdapter | Where-Object -Property Name -EQ $InterfaceAlias )) + if (-not (Find-NetworkAdapter -Name $InterfaceAlias )) { New-InvalidOperationException ` -Message ($script:localizedData.InterfaceNotAvailableError -f $InterfaceAlias) diff --git a/source/DSCResources/DSC_NetIPInterface/DSC_NetIPInterface.psm1 b/source/DSCResources/DSC_NetIPInterface/DSC_NetIPInterface.psm1 index 5cb3caad..6ed8ba67 100644 --- a/source/DSCResources/DSC_NetIPInterface/DSC_NetIPInterface.psm1 +++ b/source/DSCResources/DSC_NetIPInterface/DSC_NetIPInterface.psm1 @@ -484,7 +484,8 @@ function Get-NetworkIPInterface $($script:localizedData.GettingNetIPInterfaceMessage) -f $InterfaceAlias, $AddressFamily ) -join '') - $netIPInterface = Get-NetIPInterface @PSBoundParameters -ErrorAction SilentlyContinue + $netIPInterface = Get-NetIPInterface @PSBoundParameters ` + -ErrorAction SilentlyContinue if (-not $netIPInterface) { diff --git a/source/DSCResources/DSC_NetworkTeam/DSC_NetworkTeam.psm1 b/source/DSCResources/DSC_NetworkTeam/DSC_NetworkTeam.psm1 index c533558c..a33653ff 100644 --- a/source/DSCResources/DSC_NetworkTeam/DSC_NetworkTeam.psm1 +++ b/source/DSCResources/DSC_NetworkTeam/DSC_NetworkTeam.psm1 @@ -43,7 +43,9 @@ function Get-TargetResource } Write-Verbose -Message ($script:localizedData.GetTeamInfo -f $Name) - $networkTeam = Get-NetLBFOTeam -Name $Name -ErrorAction SilentlyContinue + $networkTeam = Get-NetLBFOTeam ` + -Name $Name ` + -ErrorAction SilentlyContinue if ($networkTeam) { @@ -121,7 +123,9 @@ function Set-TargetResource Write-Verbose -Message ($script:localizedData.GetTeamInfo -f $Name) - $networkTeam = Get-NetLBFOTeam -Name $Name -ErrorAction SilentlyContinue + $networkTeam = Get-NetLBFOTeam ` + -Name $Name ` + -ErrorAction SilentlyContinue if ($Ensure -eq 'Present') { @@ -153,7 +157,9 @@ function Set-TargetResource { Write-Verbose -Message ($script:localizedData.ModifyTeam -f $Name) - Set-NetLbfoTeam @setArguments -ErrorAction Stop -Confirm:$false + Set-NetLbfoTeam @setArguments ` + -ErrorAction Stop ` + -Confirm:$false } $netTeamMembers = Compare-Object ` @@ -172,7 +178,8 @@ function Set-TargetResource { Write-Verbose -Message ($script:localizedData.RemovingMembers -f ($membersToRemove -join ',')) - $null = Remove-NetLbfoTeamMember -Name $membersToRemove ` + $null = Remove-NetLbfoTeamMember ` + -Name $membersToRemove ` -Team $Name ` -ErrorAction Stop ` -Confirm:$false @@ -186,7 +193,8 @@ function Set-TargetResource { Write-Verbose -Message ($script:localizedData.AddingMembers -f ($membersToAdd -join ',')) - $null = Add-NetLbfoTeamMember -Name $membersToAdd ` + $null = Add-NetLbfoTeamMember ` + -Name $membersToAdd ` -Team $Name ` -ErrorAction Stop ` -Confirm:$false @@ -221,7 +229,10 @@ function Set-TargetResource { Write-Verbose -Message ($script:localizedData.RemoveTeam -f $Name) - $null = Remove-NetLbfoTeam -Name $name -ErrorAction Stop -Confirm:$false + $null = Remove-NetLbfoTeam ` + -Name $name ` + -ErrorAction Stop ` + -Confirm:$false } } @@ -277,7 +288,9 @@ function Test-TargetResource Write-Verbose -Message ($script:localizedData.GetTeamInfo -f $Name) - $networkTeam = Get-NetLbfoTeam -Name $Name -ErrorAction SilentlyContinue + $networkTeam = Get-NetLbfoTeam ` + -Name $Name ` + -ErrorAction SilentlyContinue if ($ensure -eq 'Present') { diff --git a/source/DSCResources/DSC_NetworkTeamInterface/DSC_NetworkTeamInterface.schema.mof b/source/DSCResources/DSC_NetworkTeamInterface/DSC_NetworkTeamInterface.schema.mof index b7b36416..a4dc056d 100644 --- a/source/DSCResources/DSC_NetworkTeamInterface/DSC_NetworkTeamInterface.schema.mof +++ b/source/DSCResources/DSC_NetworkTeamInterface/DSC_NetworkTeamInterface.schema.mof @@ -1,4 +1,3 @@ - [ClassVersion("1.0"), FriendlyName("NetworkTeamInterface")] class DSC_NetworkTeamInterface : OMI_BaseResource { diff --git a/source/DSCResources/DSC_ProxySettings/DSC_ProxySettings.psm1 b/source/DSCResources/DSC_ProxySettings/DSC_ProxySettings.psm1 index a9472a81..9541a380 100644 --- a/source/DSCResources/DSC_ProxySettings/DSC_ProxySettings.psm1 +++ b/source/DSCResources/DSC_ProxySettings/DSC_ProxySettings.psm1 @@ -60,7 +60,8 @@ function Get-TargetResource { $returnValue.Add('Ensure','Present') - $proxySettings = ConvertFrom-ProxySettingsBinary -ProxySettings $proxySettingsRegistryBinary + $proxySettings = ConvertFrom-ProxySettingsBinary ` + -ProxySettings $proxySettingsRegistryBinary $returnValue.Add('EnableManualProxy',$proxySettings.EnableManualProxy) $returnValue.Add('EnableAutoConfiguration',$proxySettings.EnableAutoConfiguration) @@ -392,14 +393,17 @@ function Test-TargetResource if ($connectionsRegistryValues.DefaultConnectionSettings) { - $defaultConnectionSettings = ConvertFrom-ProxySettingsBinary -ProxySettings $connectionsRegistryValues.DefaultConnectionSettings + $defaultConnectionSettings = ConvertFrom-ProxySettingsBinary ` + -ProxySettings $connectionsRegistryValues.DefaultConnectionSettings } else { $defaultConnectionSettings = @{} } - $inDesiredState = Test-ProxySettings -CurrentValues $defaultConnectionSettings -DesiredValues $desiredValues + $inDesiredState = Test-ProxySettings ` + -CurrentValues $defaultConnectionSettings ` + -DesiredValues $desiredValues if (-not $inDesiredState) { @@ -420,14 +424,17 @@ function Test-TargetResource if ($connectionsRegistryValues.SavedLegacySettings) { - $savedLegacySettings = ConvertFrom-ProxySettingsBinary -ProxySettings $connectionsRegistryValues.SavedLegacySettings + $savedLegacySettings = ConvertFrom-ProxySettingsBinary ` + -ProxySettings $connectionsRegistryValues.SavedLegacySettings } else { $savedLegacySettings = @{} } - $inDesiredState = Test-ProxySettings -CurrentValues $savedLegacySettings -DesiredValues $desiredValues + $inDesiredState = Test-ProxySettings ` + -CurrentValues $savedLegacySettings ` + -DesiredValues $desiredValues if (-not $inDesiredState) { @@ -792,7 +799,9 @@ function ConvertFrom-ProxySettingsBinary # Extract the Proxy Server string $proxyServer = '' - $stringLength = Get-Int32FromByteArray -Byte $ProxySettings -StartByte $stringPointer + $stringLength = Get-Int32FromByteArray ` + -Byte $ProxySettings ` + -StartByte $stringPointer $stringPointer += 4 if ($stringLength -gt 0) @@ -807,7 +816,9 @@ function ConvertFrom-ProxySettingsBinary # Extract the Proxy Server Exceptions string $proxyServerExceptions = @() - $stringLength = Get-Int32FromByteArray -Byte $ProxySettings -StartByte $stringPointer + $stringLength = Get-Int32FromByteArray ` + -Byte $ProxySettings ` + -StartByte $stringPointer $stringPointer += 4 if ($stringLength -gt 0) diff --git a/source/DSCResources/DSC_Route/DSC_Route.psm1 b/source/DSCResources/DSC_Route/DSC_Route.psm1 index fbdc1c24..47be08fe 100644 --- a/source/DSCResources/DSC_Route/DSC_Route.psm1 +++ b/source/DSCResources/DSC_Route/DSC_Route.psm1 @@ -613,7 +613,7 @@ function Assert-ResourceProperty ) # Validate the Adapter exists - if (-not (Get-NetAdapter | Where-Object -Property Name -EQ $InterfaceAlias )) + if (-not (Find-NetworkAdapter -Name $InterfaceAlias )) { New-InvalidArgumentException ` -Message $($($script:localizedData.InterfaceNotAvailableError) -f $InterfaceAlias) ` diff --git a/source/DSCResources/DSC_WaitForNetworkTeam/DSC_WaitForNetworkTeam.schema.mof b/source/DSCResources/DSC_WaitForNetworkTeam/DSC_WaitForNetworkTeam.schema.mof index 3034cf9a..bded4b01 100644 --- a/source/DSCResources/DSC_WaitForNetworkTeam/DSC_WaitForNetworkTeam.schema.mof +++ b/source/DSCResources/DSC_WaitForNetworkTeam/DSC_WaitForNetworkTeam.schema.mof @@ -1,4 +1,3 @@ - [ClassVersion("1.0.0.0"), FriendlyName("WaitForNetworkTeam")] class DSC_WaitForNetworkTeam : OMI_BaseResource { diff --git a/source/DSCResources/DSC_WinsServerAddress/DSC_WinsServerAddress.psm1 b/source/DSCResources/DSC_WinsServerAddress/DSC_WinsServerAddress.psm1 index e8598e34..29e90236 100644 --- a/source/DSCResources/DSC_WinsServerAddress/DSC_WinsServerAddress.psm1 +++ b/source/DSCResources/DSC_WinsServerAddress/DSC_WinsServerAddress.psm1 @@ -77,7 +77,10 @@ function Set-TargetResource Write-Verbose -Message "$($MyInvocation.MyCommand): $($script:localizedData.ApplyingWinsServerAddressesMessage)" - Set-WinsClientServerStaticAddress -InterfaceAlias $InterfaceAlias -Address $Address -ErrorAction Stop + Set-WinsClientServerStaticAddress ` + -InterfaceAlias $InterfaceAlias ` + -Address $Address ` + -ErrorAction Stop } @@ -147,7 +150,7 @@ function Assert-ResourceProperty $Address ) - if (-not (Get-NetAdapter | Where-Object Name -EQ $InterfaceAlias)) + if (-not (Find-NetworkAdapter -Name $InterfaceAlias)) { New-InvalidArgumentException ` -Message ($script:localizedData.InterfaceNotAvailableError -f $InterfaceAlias) ` diff --git a/source/Modules/NetworkingDsc.Common/NetworkingDsc.Common.psm1 b/source/Modules/NetworkingDsc.Common/NetworkingDsc.Common.psm1 index 189754ce..7e0d2c86 100644 --- a/source/Modules/NetworkingDsc.Common/NetworkingDsc.Common.psm1 +++ b/source/Modules/NetworkingDsc.Common/NetworkingDsc.Common.psm1 @@ -97,6 +97,9 @@ function Convert-CIDRToSubhetMask .PARAMETER InterfaceDescription This is the interface description of the network adapter to find. + .PARAMETER IncludeHidden + This switch indicates the adapter to find may be hidden. + .PARAMETER InterfaceIndex This is the interface index of the network adapter to find. @@ -142,6 +145,10 @@ function Find-NetworkAdapter [System.String] $InterfaceDescription, + [Parameter()] + [System.Boolean] + $IncludeHidden = $true, + [Parameter()] [System.UInt32] $InterfaceIndex, @@ -215,13 +222,13 @@ function Find-NetworkAdapter $($script:localizedData.AllNetAdaptersFoundMessage) ) -join '') - $matchingAdapters = @(Get-NetAdapter) + $matchingAdapters = @(Get-NetAdapter -IncludeHidden:$IncludeHidden) } else { # Join all the filters together $adapterFilterScript = '(' + ($adapterFilters -join ' -and ') + ')' - $matchingAdapters = @(Get-NetAdapter | + $matchingAdapters = @(Get-NetAdapter -IncludeHidden:$IncludeHidden | Where-Object -FilterScript ([ScriptBlock]::Create($adapterFilterScript))) } @@ -276,6 +283,7 @@ function Find-NetworkAdapter Status = $exactAdapter.Status MacAddress = $exactAdapter.MacAddress InterfaceDescription = $exactAdapter.InterfaceDescription + IncludeHidden = $IncludeHidden InterfaceIndex = $exactAdapter.InterfaceIndex InterfaceGuid = $exactAdapter.InterfaceGuid MatchingAdapterCount = $matchingAdapters.Count @@ -323,6 +331,7 @@ function Get-DnsClientServerStaticAddress # Look up the interface Guid $adapter = Get-NetAdapter ` -InterfaceAlias $InterfaceAlias ` + -IncludeHidden:$true ` -ErrorAction SilentlyContinue if (-not $adapter) @@ -396,7 +405,10 @@ function Get-WinsClientServerStaticAddress Write-Verbose -Message ("$($MyInvocation.MyCommand): $($script:localizedData.GettingWinsServerStaticAddressMessage -f $InterfaceAlias)") # Look up the interface Guid - $adapter = Get-NetAdapter -InterfaceAlias $InterfaceAlias -ErrorAction SilentlyContinue + $adapter = Get-NetAdapter ` + -InterfaceAlias $InterfaceAlias ` + -IncludeHidden:$true ` + -ErrorAction SilentlyContinue if (-not $adapter) { @@ -458,7 +470,10 @@ function Set-WinsClientServerStaticAddress Write-Verbose -Message ("$($MyInvocation.MyCommand): $($script:localizedData.SettingWinsServerStaticAddressMessage -f $InterfaceAlias, ($Address -join ', '))") # Look up the interface Guid - $adapter = Get-NetAdapter -InterfaceAlias $InterfaceAlias -ErrorAction SilentlyContinue + $adapter = Get-NetAdapter ` + -InterfaceAlias $InterfaceAlias ` + -IncludeHidden:$true ` + -ErrorAction SilentlyContinue if (-not $adapter) {