DSCResources/MSFT_xNetBIOS/MSFT_xNetBIOS.psm1
|
$modulePath = Join-Path -Path (Split-Path -Path (Split-Path -Path $PSScriptRoot -Parent) -Parent) -ChildPath 'Modules' # Import the Networking Common Modules Import-Module -Name (Join-Path -Path $modulePath ` -ChildPath (Join-Path -Path 'NetworkingDsc.Common' ` -ChildPath 'NetworkingDsc.Common.psm1')) # Import the Networking Resource Helper Module Import-Module -Name (Join-Path -Path $modulePath ` -ChildPath (Join-Path -Path 'NetworkingDsc.ResourceHelper' ` -ChildPath 'NetworkingDsc.ResourceHelper.psm1')) # Import Localization Strings $localizedData = Get-LocalizedData ` -ResourceName 'MSFT_xNetBIOS' ` -ResourcePath (Split-Path -Parent $Script:MyInvocation.MyCommand.Path) #region check NetBIOSSetting enum loaded, if not load try { [void][System.Reflection.Assembly]::GetAssembly([NetBiosSetting]) } catch { Add-Type -TypeDefinition @' public enum NetBiosSetting { Default, Enable, Disable } '@ } #endregion <# .SYNOPSIS Returns the current state of the Net Bios on an interface. .PARAMETER InterfaceAlias Specifies the alias of a network interface. Supports the use of '*'. .PARAMETER Setting Specifies if NetBIOS should be enabled or disabled or obtained from the DHCP server (Default). If static IP, Enable NetBIOS. Parameter value is ignored. #> function Get-TargetResource { [CmdletBinding()] [OutputType([System.Collections.Hashtable])] param ( [Parameter(Mandatory = $true)] [System.String] $InterfaceAlias, [Parameter(Mandatory = $true)] [ValidateSet("Default", "Enable", "Disable")] [System.String] $Setting ) Write-Verbose -Message ($LocalizedData.GettingNetBiosSettingMessage -f $InterfaceAlias) $netAdapter = Get-CimInstance ` -ClassName Win32_NetworkAdapter ` -Filter ('NetConnectionID="{0}"' -f $InterfaceAlias) if ($netAdapter) { Write-Verbose -Message ($localizedData.InterfaceDetectedMessage -f $InterfaceAlias, $netAdapter.InterfaceIndex) } else { New-InvalidOperationException ` -Message ($localizedData.InterfaceNotFoundError -f $InterfaceAlias) } $netAdapterConfig = $netAdapter | Get-CimAssociatedInstance ` -ResultClassName Win32_NetworkAdapterConfiguration ` -ErrorAction Stop $tcpipNetbiosOptions = $netAdapterConfig.TcpipNetbiosOptions if ($tcpipNetbiosOptions) { $Setting = $([NetBiosSetting].GetEnumValues()[$tcpipNetbiosOptions]) } else { $Setting = 'Default' } return @{ InterfaceAlias = $InterfaceAlias Setting = $Setting } } <# .SYNOPSIS Sets the state of the Net Bios on an interface. .PARAMETER InterfaceAlias Specifies the alias of a network interface. Supports the use of '*'. .PARAMETER Setting Specifies if NetBIOS should be enabled or disabled or obtained from the DHCP server (Default). If static IP, Enable NetBIOS. #> function Set-TargetResource { [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [System.String] $InterfaceAlias, [Parameter(Mandatory = $true)] [ValidateSet("Default", "Enable", "Disable")] [System.String] $Setting ) Write-Verbose -Message ($LocalizedData.SettingNetBiosSettingMessage -f $InterfaceAlias) $netAdapter = Get-CimInstance ` -ClassName Win32_NetworkAdapter ` -Filter ('NetConnectionID="{0}"' -f $InterfaceAlias) if ($netAdapter) { Write-Verbose -Message ($localizedData.InterfaceDetectedMessage -f $InterfaceAlias, $netAdapter.InterfaceIndex) } else { New-InvalidOperationException ` -Message ($localizedData.InterfaceNotFoundError -f $InterfaceAlias) } $netAdapterConfig = $netAdapter | Get-CimAssociatedInstance ` -ResultClassName Win32_NetworkAdapterConfiguration ` -ErrorAction Stop if ($Setting -eq [NetBiosSetting]::Default) { Write-Verbose -Message $LocalizedData.ResetToDefautMessage # If DHCP is not enabled, SetTcpipNetbios CIM Method won't take 0 so overwrite registry entry instead. $setItemPropertyParameters = @{ Path = "HKLM:\SYSTEM\CurrentControlSet\Services\NetBT\Parameters\Interfaces\Tcpip_$($NetAdapterConfig.SettingID)" Name = 'NetbiosOptions' Value = 0 } $null = Set-ItemProperty @setItemPropertyParameters } else { Write-Verbose -Message ($LocalizedData.SetNetBiosMessage -f $Setting) $result = $netAdapterConfig | Invoke-CimMethod ` -MethodName SetTcpipNetbios ` -ErrorAction Stop ` -Arguments @{ TcpipNetbiosOptions = [uint32][NetBiosSetting]::$Setting.value__ } if ($result.ReturnValue -ne 0) { New-InvalidOperationException ` -Message ($localizedData.FailedUpdatingNetBiosError -f $result.ReturnValue, $Setting) } } } <# .SYNOPSIS Tests the current state the Net Bios on an interface. .PARAMETER InterfaceAlias Specifies the alias of a network interface. Supports the use of '*'. .PARAMETER Setting Specifies if NetBIOS should be enabled or disabled or obtained from the DHCP server (Default). If static IP, Enable NetBIOS. #> function Test-TargetResource { [CmdletBinding()] [OutputType([System.Boolean])] param ( [Parameter(Mandatory = $true)] [System.String] $InterfaceAlias, [Parameter(Mandatory = $true)] [ValidateSet("Default", "Enable", "Disable")] [System.String] $Setting ) Write-Verbose -Message ($LocalizedData.TestingNetBiosSettingMessage -f $InterfaceAlias) $netAdapter = Get-CimInstance ` -ClassName Win32_NetworkAdapter ` -Filter ('NetConnectionID="{0}"' -f $InterfaceAlias) if ($netAdapter) { Write-Verbose -Message ($localizedData.InterfaceDetectedMessage -f $InterfaceAlias, $netAdapter.InterfaceIndex) } else { New-InvalidOperationException ` -Message ($localizedData.InterfaceNotFoundError -f $InterfaceAlias) } $currentState = Get-TargetResource @PSBoundParameters return Test-DscParameterState -CurrentValues $currentState -DesiredValues $PSBoundParameters } Export-ModuleMember -Function *-TargetResource |