PUDAdminCenterPrototype

0.1.2

Public/Get-StorageDisk.ps1

                                <#

    .SYNOPSIS

        Enumerates all of the local disks of the system.

    .DESCRIPTION

        Enumerates all of the local disks of the system.

    .NOTES

        This function is pulled directly from the real Microsoft Windows Admin Center

        PowerShell scripts use rights (according to Microsoft):

        We grant you a non-exclusive, royalty-free right to use, modify, reproduce, and distribute the scripts provided herein.

        ANY SCRIPTS PROVIDED BY MICROSOFT ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,

        INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS OR A PARTICULAR PURPOSE.

    .ROLE

        Readers

    .PARAMETER DiskId

        This parameter is OPTIONAL.

        TODO

    .EXAMPLE

        # Open an elevated PowerShell Session, import the module, and -

        PS C:\Users\zeroadmin> Get-StorageDisk

#>

function Get-StorageDisk {

    param (

        [Parameter(Mandatory = $false)]

        [String]

        $DiskId

    )

    Import-Module CimCmdlets

    Import-Module Microsoft.PowerShell.Utility

    <#

    .Synopsis

        Name: Get-Disks

        Description: Gets all the local disks of the machine.

    .Parameters

        $DiskId: The unique identifier of the disk desired (Optional - for cases where only one disk is desired).

    .Returns

        The local disk(s).

    #>

    function Get-DisksInternal

    {

        param (

            [Parameter(Mandatory = $false)]

            [String]

            $DiskId

        )

        Remove-Module Storage -ErrorAction Ignore; # Remove the Storage module to prevent it from automatically localizing

        $isDownlevel = [Environment]::OSVersion.Version.Major -lt 10;

        if ($isDownlevel)

        {

            $disks = Get-CimInstance -ClassName MSFT_Disk -Namespace Root\Microsoft\Windows\Storage | Where-Object { !$_.IsClustered };

        }

        else

        {

            $subsystem = Get-CimInstance -ClassName MSFT_StorageSubSystem -Namespace Root\Microsoft\Windows\Storage| Where-Object { $_.FriendlyName -like "Win*" };

            $disks = $subsystem | Get-CimAssociatedInstance -ResultClassName MSFT_Disk;

        }

        if ($DiskId)

        {

            $disks = $disks | Where-Object { $_.UniqueId -eq $DiskId };

        }

        $disks | %{

        $partitions = $_ | Get-CimAssociatedInstance -ResultClassName MSFT_Partition

        $volumes = $partitions | Get-CimAssociatedInstance -ResultClassName MSFT_Volume

        $volumeIds = @()

        $volumes | %{

            $volumeIds += $_.path 

        }

        $_ | Add-Member -NotePropertyName VolumeIds -NotePropertyValue $volumeIds

        }

        $disks = $disks | ForEach-Object {

           $disk = @{

                AllocatedSize = $_.AllocatedSize;

                BootFromDisk = $_.BootFromDisk;

                BusType = $_.BusType;

                FirmwareVersion = $_.FirmwareVersion;

                FriendlyName = $_.FriendlyName;

                HealthStatus = $_.HealthStatus;

                IsBoot = $_.IsBoot;

                IsClustered = $_.IsClustered;

                IsOffline = $_.IsOffline;

                IsReadOnly = $_.IsReadOnly;

                IsSystem = $_.IsSystem;

                LargestFreeExtent = $_.LargestFreeExtent;

                Location = $_.Location;

                LogicalSectorSize = $_.LogicalSectorSize;

                Model = $_.Model;

                NumberOfPartitions = $_.NumberOfPartitions;

                OfflineReason = $_.OfflineReason;

                OperationalStatus = $_.OperationalStatus;

                PartitionStyle = $_.PartitionStyle;

                Path = $_.Path;

                PhysicalSectorSize = $_.PhysicalSectorSize;

                ProvisioningType = $_.ProvisioningType;

                SerialNumber = $_.SerialNumber;

                Signature = $_.Signature;

                Size = $_.Size;

                UniqueId = $_.UniqueId;

                UniqueIdFormat = $_.UniqueIdFormat;

                volumeIds = $_.volumeIds;

                Number = $_.Number;

            }

            if (-not $isDownLevel)

            {

                $disk.IsHighlyAvailable = $_.IsHighlyAvailable;

                $disk.IsScaleOut = $_.IsScaleOut;

            }

            return $disk;

        }

        if ($isDownlevel)

        {

            $healthStatusMap = @{

                0 = 3;

                1 = 0;

                4 = 1;

                8 = 2;

            };

            $operationalStatusMap = @{

                0 = @(0);      # Unknown

                1 = @(53264);  # Online

                2 = @(53265);  # Not ready

                3 = @(53266);  # No media

                4 = @(53267);  # Offline

                5 = @(53268);  # Error

                6 = @(13);     # Lost communication

            };

            $disks = $disks | ForEach-Object {

                $_.HealthStatus = $healthStatusMap[[int32]$_.HealthStatus];

                $_.OperationalStatus = $operationalStatusMap[[int32]$_.OperationalStatus[0]];

                $_;

            };

        }

        return $disks;

    }

    if ($DiskId)

    {

        Get-DisksInternal -DiskId $DiskId

    }

    else

    {

        Get-DisksInternal

    }

}

# SIG # Begin signature block

# MIIMiAYJKoZIhvcNAQcCoIIMeTCCDHUCAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUUeM1D7eUPNE+Ntv4YncjjI8Y

# ccCgggn9MIIEJjCCAw6gAwIBAgITawAAAB/Nnq77QGja+wAAAAAAHzANBgkqhkiG

# 9w0BAQsFADAwMQwwCgYDVQQGEwNMQUIxDTALBgNVBAoTBFpFUk8xETAPBgNVBAMT

# CFplcm9EQzAxMB4XDTE3MDkyMDIxMDM1OFoXDTE5MDkyMDIxMTM1OFowPTETMBEG

# CgmSJomT8ixkARkWA0xBQjEUMBIGCgmSJomT8ixkARkWBFpFUk8xEDAOBgNVBAMT

# B1plcm9TQ0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDCwqv+ROc1

# bpJmKx+8rPUUfT3kPSUYeDxY8GXU2RrWcL5TSZ6AVJsvNpj+7d94OEmPZate7h4d

# gJnhCSyh2/3v0BHBdgPzLcveLpxPiSWpTnqSWlLUW2NMFRRojZRscdA+e+9QotOB

# aZmnLDrlePQe5W7S1CxbVu+W0H5/ukte5h6gsKa0ktNJ6X9nOPiGBMn1LcZV/Ksl

# lUyuTc7KKYydYjbSSv2rQ4qmZCQHqxyNWVub1IiEP7ClqCYqeCdsTtfw4Y3WKxDI

# JaPmWzlHNs0nkEjvnAJhsRdLFbvY5C2KJIenxR0gA79U8Xd6+cZanrBUNbUC8GCN

# wYkYp4A4Jx+9AgMBAAGjggEqMIIBJjASBgkrBgEEAYI3FQEEBQIDAQABMCMGCSsG

# AQQBgjcVAgQWBBQ/0jsn2LS8aZiDw0omqt9+KWpj3DAdBgNVHQ4EFgQUicLX4r2C

# Kn0Zf5NYut8n7bkyhf4wGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBDAEEwDgYDVR0P

# AQH/BAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUdpW6phL2RQNF

# 7AZBgQV4tgr7OE0wMQYDVR0fBCowKDAmoCSgIoYgaHR0cDovL3BraS9jZXJ0ZGF0

# YS9aZXJvREMwMS5jcmwwPAYIKwYBBQUHAQEEMDAuMCwGCCsGAQUFBzAChiBodHRw

# Oi8vcGtpL2NlcnRkYXRhL1plcm9EQzAxLmNydDANBgkqhkiG9w0BAQsFAAOCAQEA

# tyX7aHk8vUM2WTQKINtrHKJJi29HaxhPaHrNZ0c32H70YZoFFaryM0GMowEaDbj0

# a3ShBuQWfW7bD7Z4DmNc5Q6cp7JeDKSZHwe5JWFGrl7DlSFSab/+a0GQgtG05dXW

# YVQsrwgfTDRXkmpLQxvSxAbxKiGrnuS+kaYmzRVDYWSZHwHFNgxeZ/La9/8FdCir

# MXdJEAGzG+9TwO9JvJSyoGTzu7n93IQp6QteRlaYVemd5/fYqBhtskk1zDiv9edk

# mHHpRWf9Xo94ZPEy7BqmDuixm4LdmmzIcFWqGGMo51hvzz0EaE8K5HuNvNaUB/hq

# MTOIB5145K8bFOoKHO4LkTCCBc8wggS3oAMCAQICE1gAAAH5oOvjAv3166MAAQAA

# AfkwDQYJKoZIhvcNAQELBQAwPTETMBEGCgmSJomT8ixkARkWA0xBQjEUMBIGCgmS

# JomT8ixkARkWBFpFUk8xEDAOBgNVBAMTB1plcm9TQ0EwHhcNMTcwOTIwMjE0MTIy

# WhcNMTkwOTIwMjExMzU4WjBpMQswCQYDVQQGEwJVUzELMAkGA1UECBMCUEExFTAT

# BgNVBAcTDFBoaWxhZGVscGhpYTEVMBMGA1UEChMMRGlNYWdnaW8gSW5jMQswCQYD

# VQQLEwJJVDESMBAGA1UEAxMJWmVyb0NvZGUyMIIBIjANBgkqhkiG9w0BAQEFAAOC

# AQ8AMIIBCgKCAQEAxX0+4yas6xfiaNVVVZJB2aRK+gS3iEMLx8wMF3kLJYLJyR+l

# rcGF/x3gMxcvkKJQouLuChjh2+i7Ra1aO37ch3X3KDMZIoWrSzbbvqdBlwax7Gsm

# BdLH9HZimSMCVgux0IfkClvnOlrc7Wpv1jqgvseRku5YKnNm1JD+91JDp/hBWRxR

# 3Qg2OR667FJd1Q/5FWwAdrzoQbFUuvAyeVl7TNW0n1XUHRgq9+ZYawb+fxl1ruTj

# 3MoktaLVzFKWqeHPKvgUTTnXvEbLh9RzX1eApZfTJmnUjBcl1tCQbSzLYkfJlJO6

# eRUHZwojUK+TkidfklU2SpgvyJm2DhCtssFWiQIDAQABo4ICmjCCApYwDgYDVR0P

# AQH/BAQDAgeAMBMGA1UdJQQMMAoGCCsGAQUFBwMDMB0GA1UdDgQWBBS5d2bhatXq

# eUDFo9KltQWHthbPKzAfBgNVHSMEGDAWgBSJwtfivYIqfRl/k1i63yftuTKF/jCB

# 6QYDVR0fBIHhMIHeMIHboIHYoIHVhoGubGRhcDovLy9DTj1aZXJvU0NBKDEpLENO

# PVplcm9TQ0EsQ049Q0RQLENOPVB1YmxpYyUyMEtleSUyMFNlcnZpY2VzLENOPVNl

# cnZpY2VzLENOPUNvbmZpZ3VyYXRpb24sREM9emVybyxEQz1sYWI/Y2VydGlmaWNh

# dGVSZXZvY2F0aW9uTGlzdD9iYXNlP29iamVjdENsYXNzPWNSTERpc3RyaWJ1dGlv

# blBvaW50hiJodHRwOi8vcGtpL2NlcnRkYXRhL1plcm9TQ0EoMSkuY3JsMIHmBggr

# BgEFBQcBAQSB2TCB1jCBowYIKwYBBQUHMAKGgZZsZGFwOi8vL0NOPVplcm9TQ0Es

# Q049QUlBLENOPVB1YmxpYyUyMEtleSUyMFNlcnZpY2VzLENOPVNlcnZpY2VzLENO

# PUNvbmZpZ3VyYXRpb24sREM9emVybyxEQz1sYWI/Y0FDZXJ0aWZpY2F0ZT9iYXNl

# P29iamVjdENsYXNzPWNlcnRpZmljYXRpb25BdXRob3JpdHkwLgYIKwYBBQUHMAKG

# Imh0dHA6Ly9wa2kvY2VydGRhdGEvWmVyb1NDQSgxKS5jcnQwPQYJKwYBBAGCNxUH

# BDAwLgYmKwYBBAGCNxUIg7j0P4Sb8nmD8Y84g7C3MobRzXiBJ6HzzB+P2VUCAWQC

# AQUwGwYJKwYBBAGCNxUKBA4wDDAKBggrBgEFBQcDAzANBgkqhkiG9w0BAQsFAAOC

# AQEAszRRF+YTPhd9UbkJZy/pZQIqTjpXLpbhxWzs1ECTwtIbJPiI4dhAVAjrzkGj

# DyXYWmpnNsyk19qE82AX75G9FLESfHbtesUXnrhbnsov4/D/qmXk/1KD9CE0lQHF

# Lu2DvOsdf2mp2pjdeBgKMRuy4cZ0VCc/myO7uy7dq0CvVdXRsQC6Fqtr7yob9NbE

# OdUYDBAGrt5ZAkw5YeL8H9E3JLGXtE7ir3ksT6Ki1mont2epJfHkO5JkmOI6XVtg

# anuOGbo62885BOiXLu5+H2Fg+8ueTP40zFhfLh3e3Kj6Lm/NdovqqTBAsk04tFW9

# Hp4gWfVc0gTDwok3rHOrfIY35TGCAfUwggHxAgEBMFQwPTETMBEGCgmSJomT8ixk

# ARkWA0xBQjEUMBIGCgmSJomT8ixkARkWBFpFUk8xEDAOBgNVBAMTB1plcm9TQ0EC

# E1gAAAH5oOvjAv3166MAAQAAAfkwCQYFKw4DAhoFAKB4MBgGCisGAQQBgjcCAQwx

# CjAIoAKAAKECgAAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGC

# NwIBCzEOMAwGCisGAQQBgjcCARUwIwYJKoZIhvcNAQkEMRYEFJcTGsHbcQ13Sg5k

# JgiCTTyQ6csqMA0GCSqGSIb3DQEBAQUABIIBABE7n9zImHxtYqLVhndb9wrq+o2J

# OBiHMQs5XQbKBTQ535n8t7UIEI+a0EnF4Ajp+lLj3HMJ13u+5HiD20yN3mcfsKGn

# T4mFQt7JdYJreIMnW99eAsyW3LbWPiMj5sV3wDgiub8zSIjLNK9ukQjjM9nmXTZQ

# CIGeioRijd834y1OhlF2kupEzKSIzfxwQD4UFVPNPTJgeFlMnFj9+ia4gnVnCXSO

# HMxygGtK1JRzDyxUNySiFsF/k2G2ErYDdVig+oYSucO5O5Q4KuylqqKqrT28bwG+

# cHwAbQebxzDi/R458z7UBkPjP7M80kqCYVl4BjlILUhRZcYJsty4wQ14LEM=

# SIG # End signature block