ADReportingTools

1.4.0

functions/get-adsitesubnet.ps1

Function Get-ADSiteSummary {
    [cmdletbinding()]
    [OutPutType("ADSiteSummary")]
    Param(
        [Parameter(Position = 0,HelpMessage = "Specify the name of an Active Directory site. The default is all sites.")]
        [ValidateNotNullOrEmpty()]
        [string]$Name,
        [Parameter(HelpMessage = "Specify a domain controller to query.")]
        [alias("dc", "domaincontroller")]
        [string]$Server,
        [Parameter(HelpMessage = "Specify an alternate credential.")]
        [alias("RunAs")]
        [PSCredential]$Credential
    )

    Write-Verbose "Starting $($MyInvocation.MyCommand)"

    $getParams = @{
        ErrorAction = "Stop"
        Properties  = "Subnets", "WhenChanged", "WhenCreated"
    }
    if ($Name) {
        Write-Verbose "Getting site $Name"
        $getparams.Add("Identity",$Name)
    }
    else {
        Write-Verbose "Getting all sites"
        $getParams.Add("Filter", "*")
    }

    if ($server) {
        Write-Verbose "Querying domain controller $server"
        $getParams.Add("server", $server)
    }
    if ($Credential.UserName) {
        Write-Verbose "Using alternate credential for $($credential.username)"
        $getParams.Add("Credential", $Credential)
    }

    try {
        Write-Verbose "Getting AD Replication sites"
        #get sites first and then subnets for each site. This will make grouping and formatting
        #results easier

        $sites = Get-ADReplicationSite @getParams

        Write-Verbose "Found $(($sites | Measure-Object).count) sites"
        $getParams["Properties"] = "Name", "Description", "Location", "WhenChanged", "WhenCreated"

        $getParams.Remove("Identity")
        $getParams.Remove("filter")
        foreach ($site in $sites) {
            Write-Verbose "Getting subnets associated with $($site.name)"

            #"site -eq $($site.distinguishedname)"
            Write-Verbose "Found $($site.subnets.count) subnets"

            $data = $site.subnets | Sort-Object | Get-ADReplicationSubnet @getParams
            foreach ($item in $data) {
                [pscustomobject]@{
                    PSTypename        = "ADSiteSummary"
                    Site              = $site.Name
                    SiteDescription   = $site.Description
                    Subnet            = $item.Name
                    SubnetDescription = $item.Description
                    SubnetLocation    = $item.Location
                    SiteCreated       = $site.WhenCreated
                    SiteModified      = $site.WhenChanged
                    SubnetCreated     = $item.WhenCreated
                    SubnetModified    = $item.WhenChanged
                }
            } #foreach item
        } #foreach site
    }
    Catch {
        throw $_
    }

    Write-Verbose "Ending $($MyInvocation.MyCommand)"
}

Function Get-ADSiteDetail {
    [cmdletbinding()]
    [OutPutType("ADSiteDetail")]
    Param(
        [Parameter(Position = 0,HelpMessage = "Specify the name of an Active Directory site. The default is all sites.")]
        [ValidateNotNullOrEmpty()]
        [string]$Name,
        [Parameter(HelpMessage = "Specify a domain controller to query.")]
        [alias("dc", "domaincontroller")]
        [string]$Server,
        [Parameter(HelpMessage = "Specify an alternate credential.")]
        [alias("RunAs")]
        [PSCredential]$Credential
    )
    Write-Verbose "Starting $($MyInvocation.MyCommand)"

    $data = Get-ADSiteSummary @psboundparameters | Group-Object -Property Site

    if ($data) {
        foreach ($item in $data) {
            #create a new custom object
            [PSCustomObject]@{
                PSTypename  = "ADSiteDetail"
                Name        = $item.Name
                Description = $item.group[0].SiteDescription
                SubnetCount = $item.count
                Subnets     = $item.group.subnet
                Created     = $item.group[0].SubnetCreated
                Modified    = $item.group[0].SubnetModified
            }
        }
    }
    else {
        Write-Warning "Failed to get site and subnet information."
    }

    Write-Verbose "Ending $($MyInvocation.MyCommand)"
}