Functions/Get-InvalidFileCharacter.ps1
|
function Get-InvalidFileCharacter { <# .SYNOPSIS Gets invalid filename characters .DESCRIPTION Gets invalid filename characters. Function aliased to 'Show-InvalidFileCharacter' for backward compatibility. .PARAMETER IncludeValues Switch indicating that decimal and hexadecimal representations of characters are to be included in output .PARAMETER Printable Switch indicating that only printable characters are to be in the output .EXAMPLE Get-InvalidFileCharacter -Printable Would return " < > | : * ? \ / .EXAMPLE Get-InvalidFileCharacter -Printable -IncludeValues Would return Char Dec Hex ---- --- --- " 34 22 < 60 3c > 62 3e | 124 7c : 58 3a * 42 2a ? 63 3f \ 92 5c / 47 2f #> [CmdletBinding(ConfirmImpact='None')] [outputtype([char[]])] Param ( [switch] $IncludeValues, [switch] $Printable ) begin { Write-Verbose -Message "Starting [$($MyInvocation.Mycommand)]" } process { $Invalid = [System.IO.Path]::GetInvalidFileNameChars() | Select-Object @{Name='Char';Expr={$_.ToString()}}, @{Name='Dec';Expr={[int][char] $_}}, @{Name='Hex';Expr={'{0:x}' -f ([int][char] $_)}} if ($Printable) { $Invalid = $Invalid | Where-Object {$_.Dec -gt 32} } if ($IncludeValues) { Write-Output -InputObject $Invalid } else { Write-Output -InputObject $Invalid.Char } } end { Write-Verbose -Message "Ending [$($MyInvocation.Mycommand)]" } } # for backward compatibility Set-Alias -Name 'Show-InvalidFileCharacter' -Value 'Get-InvalidFileCharacter' -Description 'Alias for Get-InvalidFileCharacter for backward compatibility' |