AsBuiltReport.VMware.AppVolumes

0.2.0

Src/Private/Get-AbrAppVolStorageGroup.ps1

function Get-AbrAppVolStorageGroup {
    <#
    .SYNOPSIS
        Used by As Built Report to retrieve VMware APPVolume Storage Group information.
    .DESCRIPTION
        Documents the configuration of VMware APPVolume in Word/HTML/Text formats using PScribo.
    .NOTES
        Version: 0.2.0
        Author: Chris Hildebrandt, @childebrandt42
        Editor: Jonathan Colon, @jcolonfzenpr
        Twitter: @asbuiltreport
        Github: AsBuiltReport
        Credits: Iain Brighton (@iainbrighton) - PScribo module
 
 
    .LINK
        https://github.com/AsBuiltReport/AsBuiltReport.VMware.AppVolumes
    #>

    [CmdletBinding()]
    param (
    )

    begin {
        Write-PScriboMessage "StorageGroups InfoLevel set at $($InfoLevel.AppVolumes.StorageGroups)."
        Write-PscriboMessage "Collecting App Volumes Datastore information."
    }

    process {
        if ($InfoLevel.AppVolumes.StorageGroups -ge 1) {
            try {
                if ($PSVersionTable.PSEdition -eq 'Core') {
                    $StorageGroups = Invoke-RestMethod -SkipCertificateCheck -WebSession $SourceServerSession -Method Get -Uri "https://$AppVolServer/cv_api/storage_groups"
                } else {$StorageGroups = Invoke-RestMethod -WebSession $SourceServerSession -Method Get -Uri "https://$AppVolServer/cv_api/storage_groups"}

                if ($StorageGroups) {
                    section -Style Heading3 "Storage Groups" {
                        Paragraph "The following section details Storage Group used to define groups of storage locations so they can function as one storage entity."
                        BlankLine
                        $OutObj = @()
                        foreach ($StorageGroup in $StorageGroups.storage_groups | Sort-Object -Property Name) {
                            section -Style Heading3 $StorageGroup.name {
                                try {
                                    $inObj = [ordered] @{
                                        'Distribution Strategy' = $StorageGroup.strategy
                                        'Template Storage' = $StorageGroup.template_storage
                                        'Members Count' = $StorageGroup.members
                                        'Member Name Prefix' = $StorageGroup.member_prefix
                                        'Space Used' = $StorageGroup.space_used
                                        'Total Space' = $StorageGroup.space_total
                                        'Creation Date' = $StorageGroup.created_at_human
                                        'Auto Import' = $StorageGroup.auto_import
                                        'Auto Replicate' = $StorageGroup.auto_replicate
                                        'Last Replicated Date' = $StorageGroup.replicated_at_human
                                        'Last Imported Date' = $StorageGroup.imported_at_human
                                        'Last Curated Date' = $StorageGroup.curated_at_human
                                    }
                                    $OutObj = [pscustomobject](ConvertTo-HashToYN $inObj)

                                    $TableParams = @{
                                        Name = "Storage Group - $($StorageGroup.name)"
                                        List = $true
                                        ColumnWidths = 50, 50
                                    }
                                    if ($Report.ShowTableCaptions) {
                                        $TableParams['Caption'] = "- $($TableParams.Name)"
                                    }
                                    $OutObj | Table @TableParams
                                    if ($PSVersionTable.PSEdition -eq 'Core') {
                                        $StorageGroupDetails = Invoke-RestMethod -SkipCertificateCheck -WebSession $SourceServerSession -Method Get -Uri "https://$AppVolServer/cv_api/storage_groups/$($StorageGroup.id)"
                                    } else {$StorageGroupDetails = Invoke-RestMethod -WebSession $SourceServerSession -Method Get -Uri "https://$AppVolServer/cv_api/storage_groups/$($StorageGroup.id)"}

                                    if ($StorageGroupDetails) {
                                        section -ExcludeFromTOC -Style NOTOCHeading4 'Datastore Members' {
                                            $OutObj = @()
                                            foreach ($StorageGroupDetail in $StorageGroupDetails.storage_group.storages) {
                                                try {
                                                    $inObj = [ordered] @{
                                                        'Name' = $StorageGroupDetail.Name
                                                        'DataCenter' = $StorageGroupDetail.datacenter
                                                        'Space Used' = $StorageGroupDetail.space_used
                                                        'Space Total' = $StorageGroupDetail.space_total
                                                        'Is Deleted' = $StorageGroupDetail.deleted
                                                    }
                                                    $OutObj += [pscustomobject](ConvertTo-HashToYN $inObj)

                                                }
                                                catch {
                                                    Write-PscriboMessage -IsWarning $_.Exception.Message
                                                }
                                            }

                                            $TableParams = @{
                                                Name = "Datastore Members - $($StorageGroup.name)"
                                                List = $false
                                                ColumnWidths = 30, 30, 14, 13, 13
                                            }
                                            if ($Report.ShowTableCaptions) {
                                                $TableParams['Caption'] = "- $($TableParams.Name)"
                                            }
                                            $OutObj| Sort-Object -Property Name | Table @TableParams
                                        }
                                    }
                                }
                                catch {
                                    Write-PscriboMessage -IsWarning $_.Exception.Message
                                }
                            }
                        }
                    }
                }
            }
            catch {
                Write-PscriboMessage -IsWarning $_.Exception.Message
            }
        }
    }
    end {}
}