functions/Get-DbaWsfcDisk.ps1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
#ValidationTags#Messaging,FlowControl,Pipeline,CodeStyle#
function Get-DbaWsfcDisk {
<#
    .SYNOPSIS
        Gets information about the clustered disks on one or more failover clusters in a given domain.
 
    .DESCRIPTION
        Gets information about the clustered disks on one or more failover clusters in a given domain.
 
        All Windows Server Failover Clustering (Wsfc) commands require local admin on each member node.
 
    .PARAMETER ComputerName
        The target cluster name. Can be a node or the cluster name itself.
 
    .PARAMETER Credential
        Allows you to login to the cluster using alternative credentials.
 
    .PARAMETER EnableException
        By default, when something goes wrong we try to catch it, interpret it and give you a friendly warning message.
        This avoids overwhelming you with "sea of red" exceptions, but is inconvenient because it basically disables advanced scripting.
        Using this switch turns this "nice by default" feature off and enables you to catch exceptions with your own try/catch.
 
    .NOTES
        Tags: Cluster, WSFC, FCI, HA
        Author: Chrissy LeMaire (@cl), netnerds.net
 
        Website: https://dbatools.io
        Copyright: (c) 2018 by dbatools, licensed under MIT
        License: MIT https://opensource.org/licenses/MIT
 
    .LINK
        https://dbatools.io/Get-DbaWsfcDisk
 
    .EXAMPLE
        PS C:\> Get-DbaWsfcDisk -ComputerName cluster01
 
        Gets disk information from the failover cluster cluster01
 
#>

    [CmdletBinding()]
    param (
        [parameter(ValueFromPipeline)]
        [DbaInstanceParameter[]]$ComputerName = $env:COMPUTERNAME,
        [PSCredential]$Credential,
        [switch]$EnableException
    )
    process {
        foreach ($computer in $computername) {
            $resources = Get-DbaWsfcResource -ComputerName $computer -Credential $Credential | Where-Object Type -eq 'Physical Disk'
            foreach ($resource in $resources) {
                $disks = $resource | Get-CimAssociatedInstance -ResultClassName MSCluster_Disk
                foreach ($disk in $disks) {
                    $diskpart = $disk | Get-CimAssociatedInstance -ResultClassName MSCluster_DiskPartition
                    [pscustomobject]@{
                        ClusterName = $resource.ClusterName
                        ClusterFqdn = $resource.ClusterFqdn
                        ResourceGroup = $resource.OwnerGroup
                        Disk        = $resource.Name
                        State       = $resource.State
                        FileSystem  = $diskpart.FileSystem
                        Path        = $diskpart.Path
                        Label       = $diskpart.VolumeLabel
                        Size        = [dbasize]($diskpart.TotalSize * 1MB)
                        Free        = [dbasize]($diskpart.FreeSpace * 1MB)
                        MountPoints = $diskpart.MountPoints
                        SerialNumber = $diskpart.SerialNumber
                        ClusterDisk        = $disk
                        ClusterDiskPart    = $diskpart
                        ClusterResource    = $resource
                    } | Select-DefaultView -ExcludeProperty ClusterDisk, ClusterDiskPart, ClusterResource
                }
            }
        }
    }
}