AsBuiltReport.Microsoft.AD

0.3.0

Src/Private/Get-AbrADDCDiag.ps1

function Get-AbrADDCDiag {
    <#
    .SYNOPSIS
    Used by As Built Report to retrieve Microsoft AD Domain Sites information.
    .DESCRIPTION
 
    .NOTES
        Version: 0.3.0
        Author: Jonathan Colon
        Twitter: @jcolonfzenpr
        Github: rebelinux
    .EXAMPLE
 
    .LINK
 
    #>
    [CmdletBinding()]
    param (
        [Parameter (
            Position = 0,
            Mandatory)]
            [string]
            $Domain,
            [string]
            $DC,
            $Session
    )

    begin {
        Write-PscriboMessage "Discovering Active Directory DCDiag information for domain $Domain."
    }

    process {
        $OutObj = @()
        if ($DC) {
            try {
                Write-PscriboMessage "Discovering Active Directory DCDiag information for DC $DC."
                $DCDIAG = Invoke-DcDiag -DomainController $DC
                Write-PscriboMessage "Discovered Active Directory DCDiag information for DC $DC."
                foreach ($Result in $DCDIAG) {
                    Write-PscriboMessage "Collecting Active Directory DCDiag test '$($Result.TestName)' for DC $DC."
                    $inObj = [ordered] @{
                        'DC Name' = $DC
                        'Test Name' = $Result.TestName
                        'Result' = $Result.TestResult
                    }
                    $OutObj += [pscustomobject]$inobj
                }
            $TableParams = @{
                Name = "AD Domain Controller DCDiag Information - $($Domain.ToString().ToUpper())"
                List = $false
                ColumnWidths = 35, 35, 30
            }
            if ($Report.ShowTableCaptions) {
                $TableParams['Caption'] = "- $($TableParams.Name)"
            }
            $OutObj | Table @TableParams
        }
        catch {
            Write-PscriboMessage -IsWarning "Error: Connecting to remote server $DC failed: WinRM cannot complete the operation."
            Write-PScriboMessage -IsDebug $_.Exception.Message
        }
    }
    }

    end {}

}