xDhcpServer

3.1.1

DSCResources/MSFT_xDhcpServerAuthorization/MSFT_xDhcpServerAuthorization.psm1

$script:resourceHelperModulePath = Join-Path -Path $PSScriptRoot -ChildPath '../../Modules/DscResource.Common'
$script:moduleHelperPath = Join-Path -Path $PSScriptRoot -ChildPath '../../Modules/DhcpServerDsc.Common'

Import-Module -Name $script:resourceHelperModulePath
Import-Module -Name $script:moduleHelperPath

$script:localizedData = Get-LocalizedData -DefaultUICulture 'en-US'

function Get-TargetResource
{
    [CmdletBinding()]
    [OutputType([System.Collections.Hashtable])]
    param
    (
        [Parameter(Mandatory = $true)]
        [ValidateSet('Yes')]
        [System.String]
        $IsSingleInstance,

        [Parameter(Mandatory = $true)]
        [ValidateSet('Present', 'Absent')]
        [System.String]
        $Ensure,

        [Parameter()]
        [ValidateNotNullOrEmpty()]
        [System.String]
        $DnsName = (Get-Hostname),

        [Parameter()]
        [ValidateNotNullOrEmpty()]
        [System.String]
        $IPAddress = (Get-IPv4Address | Select-Object -First 1)
    )

    Write-Verbose -Message (
        $script:localizedData.GetServerAuthorizationMessage -f $ScopeId
    )

    Assert-Module -ModuleName 'DHCPServer'

    $IPAddress = Get-ValidIPAddress -IPString $IPAddress -AddressFamily 'IPv4' -ParameterName 'IPAddress'

    $dhcpServer = Get-DhcpServerInDC | Where-Object -FilterScript {
        ($_.DnsName -eq $DnsName) -and ($_.IPAddress -eq $IPAddress)
    }

    $targetResource = @{
        DnsName   = $dhcpServer.DnsName
        IPAddress = $dhcpServer.IPAddress
    }

    if ($dhcpServer)
    {
        Write-Verbose ($script:localizedData.ServerIsAuthorized -f $DnsName, $IPAddress)

        $targetResource['Ensure'] = 'Present'
    }
    else
    {
        Write-Verbose ($script:localizedData.ServerNotAuthorized -f $DnsName, $IPAddress)

        $targetResource['Ensure'] = 'Absent'
    }

    return $targetResource
}

function Set-TargetResource
{
    [CmdletBinding()]
    param
    (
        [Parameter(Mandatory = $true)]
        [ValidateSet('Yes')]
        [System.String]
        $IsSingleInstance,

        [Parameter(Mandatory = $true)]
        [ValidateSet('Present', 'Absent')]
        [System.String]
        $Ensure,

        [Parameter()]
        [ValidateNotNullOrEmpty()]
        [System.String]
        $DnsName = (Get-Hostname),

        [Parameter()]
        [ValidateNotNullOrEmpty()]
        [System.String]
        $IPAddress = (Get-IPv4Address | Select-Object -First 1)
    )

    Write-Verbose -Message (
        $script:localizedData.SetServerAuthorizationMessage -f $ScopeId
    )

    Assert-Module -ModuleName 'DHCPServer'

    $IPAddress = Get-ValidIPAddress -IPString $IPAddress -AddressFamily 'IPv4' -ParameterName 'IPAddress'

    if ($Ensure -eq 'Present')
    {
        Write-Verbose ($script:localizedData.AuthorizingServer -f $DnsName, $IPAddress)

        Add-DhcpServerInDc -DnsName $DnsName -IPAddress $IPAddress
    }
    elseif ($Ensure -eq 'Absent')
    {
        Write-Verbose ($script:localizedData.UnauthorizingServer -f $DnsName, $IPAddress)

        Get-DhcpServerInDC | Where-Object -FilterScript {
            ($_.DnsName -eq $DnsName) -and ($_.IPAddress -eq $IPAddress)
        } | Remove-DhcpServerInDc
    }
}

function Test-TargetResource
{
    [CmdletBinding()]
    [OutputType([System.Boolean])]
    param
    (
        [Parameter(Mandatory = $true)]
        [ValidateSet('Yes')]
        [System.String]
        $IsSingleInstance,

        [Parameter(Mandatory = $true)]
        [ValidateSet('Present', 'Absent')]
        [System.String]
        $Ensure,

        [Parameter()]
        [ValidateNotNullOrEmpty()]
        [System.String]
        $DnsName = (Get-Hostname),

        [Parameter()]
        [ValidateNotNullOrEmpty()]
        [System.String]
        $IPAddress = (Get-IPv4Address | Select-Object -First 1)
    )

    Write-Verbose -Message (
        $script:localizedData.TestServerAuthorizationMessage -f $ScopeId
    )

    $targetResource = Get-TargetResource @PSBoundParameters

    $isCompliant = $true

    if ($targetResource.Ensure -ne $Ensure)
    {
        Write-Verbose ($script:localizedData.IncorrectPropertyValue -f 'Ensure', $Ensure, $targetResource.Ensure)
        $isCompliant = $false

    }
    elseif ($Ensure -eq 'Present')
    {
        if ($targetResource.DnsName -ne $DnsName)
        {
            Write-Verbose ($script:localizedData.IncorrectPropertyValue -f 'DnsName', $DnsName, $targetResource.DnsName)
            $isCompliant = $false
        }

        if ($targetResource.IPAddress -ne $IPAddress)
        {
            Write-Verbose ($script:localizedData.IncorrectPropertyValue -f 'IPAddress', $IPAddress, $targetResource.IPAddress)
            $isCompliant = $false
        }
    }

    if ($isCompliant)
    {
        Write-Verbose ($script:localizedData.ResourceInDesiredState -f $DnsName)
    }
    else
    {
        Write-Verbose ($script:localizedData.ResourceNotInDesiredState -f $DnsName)
    }

    return $isCompliant
}

## Internal function used to return all IPv4 addresses
function Get-IPv4Address
{
    [CmdletBinding()]
    [OutputType([System.String])]
    param ()
    process
    {
        Write-Verbose -Message $script:localizedData.ResolvingIPv4Address

        Get-CimInstance -ClassName 'Win32_NetworkAdapterConfiguration' -Namespace 'root\CIMV2' |
            Where-Object -FilterScript {
                $_.IPEnabled -eq 'True' -and $_.IPAddress -notmatch ':'
            } |
                Select-Object -ExpandProperty 'IPAddress'
    } #end process
} #end function Get-IPv4Address

## Internal function used to resolve the local hostname
function Get-Hostname
{
    [CmdletBinding()]
    [OutputType([System.String])]
    param ()
    process
    {
        Write-Verbose $script:localizedData.ResolvingHostname

        $globalIpProperties = [System.Net.NetworkInformation.IPGlobalProperties]::GetIPGlobalProperties()

        if ($globalIpProperties.DomainName)
        {
            return '{0}.{1}' -f $globalIpProperties.HostName, $globalIpProperties.DomainName
        }
        else
        {
            return $globalIpProperties.HostName
        }
    } #end process
} #end function Get-Hostname

Export-ModuleMember -Function *-TargetResource