[Get Mapped Drives (Powershell)] An easy way to determine a remote host's active user's current drive mappings. #windows #utility #powershellcore #powershell #pwsh

Get-MappedDrive.ps1

function Get-MappedDrive {
        <#
                .SYNOPSIS
                Returns the active drive mappings of a hosts current user session

                .DESCRIPTION
                Get-MappedDrive is a function which (optionally) takes a remote host and returns the active drive mappings the current user session

                .PARAMETER ComputerName
                Specifies a remote host

                .EXAMPLE
                Get-MappedDrive [-ComputerName <Remote Host>]

                .INPUTS
                String

                .OUTPUTS
                PSCustomObject

                .NOTES
                Author:  Dave Edwards
                Twitter: @soulhakr
        #>

        [CmdletBinding()]
        param (
                [Parameter(Mandatory=$false)]
                [Alias("w")]
                [string] $ComputerName
        )
        
        $hostname = if ($PSBoundParameters.ContainsKey('ComputerName') -and (-not [String]::IsNullOrEmpty($ComputerName))) {
                $ComputerName
        } else {
                (Get-CimInstance -ClassName CIM_ComputerSystem).Name     
        }
        
        Write-Host "Drives currently mapped on $($hostname):"

        Get-CimInstance -ClassName 'Win32_MappedLogicalDisk' -Namespace 'root\CIMV2' -ComputerName $hostname | Select-Object -Property DeviceID, ProviderName, Name, Caption, Description | Format-Table -AutoSize
}