Diagrammer.Microsoft.AD

0.1.1

Src/Private/Get-RequiredFeature.ps1

function Get-RequiredFeature {
    <#
    .SYNOPSIS
        Function to check if the required version of windows feature is installed
    .DESCRIPTION
        Function to check if the required version of windows feature is installed
    .NOTES
        Version: 0.1.0
        Author: Jonathan Colon
        Twitter: @jcolonfzenpr
        Github: rebelinux
    .PARAMETER Name
        The name of the required windows feature
    .PARAMETER Version
        The version of the required windows feature
    #>

    Param
    (
        [CmdletBinding()]
        [Parameter(Mandatory = $true, ValueFromPipeline = $false)]
        [ValidateNotNullOrEmpty()]
        [String]
        $Name,

        [Parameter(Mandatory = $true, ValueFromPipeline = $false)]
        [ValidateNotNullOrEmpty()]
        [String]
        $OSType
    )

    process {
        # Check if the required version of Module is installed
        if ($OSType -eq 'WorkStation') {
            $RequiredFeature = Get-WindowsCapability -online -Name $Name
            if ($RequiredFeature.State -ne 'Installed')  {
                throw "$Name is required to run the Diagrammer.Microsoft.AD. Run 'Add-WindowsCapability -online -Name '$($Name)'' to install the required modules. https://github.com/rebelinux/Diagrammer.Microsoft.AD"
            }
        }
        elseif ($OSType -eq 'Server' -or $OSType -eq 'DomainController') {
            $RequiredFeature = Get-WindowsFeature -Name $Name
            if ($RequiredFeature.InstallState -ne 'Installed')  {
                throw "$Name is required to run the Diagrammer.Microsoft.AD. Run 'Install-WindowsFeature -Name '$($Name)'' to install the required modules. https://github.com/rebelinux/Diagrammer.Microsoft.AD"
            }
        }
        else {
            throw "Unable to validate if $Name is installed."
        }
    }
    end {}
}