2019-03-14发表2022-07-06更新powershell / tip3 分钟读完 (大约431个字)

PowerShell 技能连载 - 检查 Cmdlet 可用性和脚本兼容性（第 3 部分）

并不是所有的 PowerShell cmdlet 都随着 PowerShell 发行。许多 cmdlet 是随着第三方模块发布。当安装某些软件时会同时安装这些模块，或者需要使用特定的 Windows 版本。

在之前的部分中我们创建了一个函数，它能够获取某个脚本中的所有外部命令。只需要再做一些额外努力，这就可以变成一个有用的兼容性报告：来自某个模块的所有 cmdlet，或者随着 PowerShell 发行的所有以 “Microsoft.PowerShell” 开头的模块。任何其它模块都属于具体的 Windows 版本或第三方扩展。

检查这个函数：

function Get-ExternalCommand
{
    param
    (
        [Parameter(Mandatory)][string]
        $Path
    )
    function Get-ContainedCommand
    {
        param
        (
            [Parameter(Mandatory)][string]
            $Path,

            [string][ValidateSet('FunctionDefinition','Command')]
            $ItemType
        )

        $Token = $Err = $null
        $ast = [Management.Automation.Language.Parser]::ParseFile($Path, [ref] $Token, [ref] $Err)

        $ast.FindAll({ $args[0].GetType().Name -eq "${ItemType}Ast" }, $true)

    }


$functionNames = Get-ContainedCommand $Path -ItemType FunctionDefinition |
  Select-Object -ExpandProperty Name

    $commands = Get-ContainedCommand $Path -ItemType Command
    $commands | Where-Object {
      $commandName = $_.CommandElements[0].Extent.Text
      $commandName -notin $functionNames
      } |
      ForEach-Object { $_.GetCommandName() } |
      Sort-Object -Unique |
      ForEach-Object {
    $module = (Get-Command -name $_).Source
    $builtIn = $module -like 'Microsoft.PowerShell.*';

    [PSCustomObject]@{
        Command = $_
        BuiltIn = $builtIn
        Module = $module
    }
    }
}

以下是根据一个 PowerShell 脚本生成的一个示例报告，它列出了所有外部的 cmdlet，以及它们是否是 PowerShell 的一部分或来自外部模块：

PS> Get-ExternalCommand -Path $Path


Command                BuiltIn Module
-------                ------- ------
ConvertFrom-StringData    True Microsoft.PowerShell.Utility
Get-Acl                   True Microsoft.PowerShell.Security
Get-ItemProperty          True Microsoft.PowerShell.Management
Get-Service               True Microsoft.PowerShell.Management
Get-WmiObject             True Microsoft.PowerShell.Management
New-Object                True Microsoft.PowerShell.Utility
out-default               True Microsoft.PowerShell.Core
Test-Path                 True Microsoft.PowerShell.Management
Where-Object              True Microsoft.PowerShell.Core
write-host                True Microsoft.PowerShell.Utility

PS>

2019-03-13发表2022-07-06更新powershell / tip2 分钟读完 (大约307个字)

PowerShell 技能连载 - 检查 Cmdlet 可用性和脚本兼容性（第 2 部分）

在前一部分中我们处理了一个脚本并且读出这个脚本所使用的所有外部命令。我们用这个函数合并了找到的所有外部命令：

function Get-ExternalCommand
{
    param
    (
        [Parameter(Mandatory)][string]
        $Path
    )
    function Get-ContainedCommand
    {
        param
        (
            [Parameter(Mandatory)][string]
            $Path,

            [string][ValidateSet('FunctionDefinition','Command')]
            $ItemType
        )

        $Token = $Err = $null
        $ast = [Management.Automation.Language.Parser]::ParseFile($Path, [ref] $Token, [ref] $Err)

        $ast.FindAll({ $args[0].GetType().Name -eq "${ItemType}Ast" }, $true)

    }


$functionNames = Get-ContainedCommand $Path -ItemType FunctionDefinition |
   Select-Object -ExpandProperty Name

    $commands = Get-ContainedCommand $Path -ItemType Command
    $commands | Where-Object {
      $commandName = $_.CommandElements[0].Extent.Text
      $commandName -notin $functionNames
      } |
      ForEach-Object { $_.GetCommandName() } |
      Sort-Object -Unique
}

您可以向这个函数传入任何 PowerShell 脚本路径并且得到这个脚本使用的所有外部命令（只需要确保在 $path 中传入了一个脚本的合法路径）：

PS C:\> Get-ExternalCommand -Path $Path
ConvertFrom-StringData
Get-Acl
Get-ItemProperty
Get-Service
Get-WmiObject
New-Object
out-default
Test-Path
Where-Object
write-host

2019-03-12发表2022-07-06更新powershell / tip3 分钟读完 (大约394个字)

PowerShell 技能连载 - 检查 Cmdlet 可用性和脚本兼容性（第 1 部分）

要查看您的脚本的兼容性，在第一部分中我们先看看如何查找一个脚本实际使用哪些命令。以下是一个帮助函数，能够利用 PowerShell 内部的抽象语法树 (AST) 来检测命令：

function Get-ContainedCommand
{
    param
    (
        [Parameter(Mandatory)][string]
        $Path,

        [string][ValidateSet('FunctionDefinition','Command')]
        $ItemType
    )

    $Token = $Err = $null
    $ast = [Management.Automation.Language.Parser]::ParseFile($Path, [ref] $Token, [ref] $Err)

    $ast.FindAll({ $args[0].GetType().Name -eq "${ItemType}Ast" }, $true)

Get-ContainedCommand 可以解析一个脚本中定义的函数，或是一个脚本中使用的命令。以下是获取某个脚本中所有定义的函数的代码：

$Path = "C:\scriptToPS1File\WithFunctionDefinitionsInIt.ps1"

$functionNames = Get-ContainedCommand $Path -ItemType FunctionDefinition |
  Select-Object -ExpandProperty Name

$functionNames

以下是脚本内部使用的命令列表：

1 2	$commands = Get-ContainedCommand $Path -ItemType Command $commands.Foreach{$_.CommandElements[0].Extent.Text}

要找出使用外部命令的地方，只需要从命令列表中减掉所有内部定义的函数，然后移除重复。以下将获取某个脚本用到的所有外部命令：

$Path = "C:\scriptToPS1File\WithFunctionDefinitionsInIt.ps1"

$functionNames = Get-ContainedCommand $Path -ItemType FunctionDefinition |
  Select-Object -ExpandProperty Name

$commands = Get-ContainedCommand $Path -ItemType Command

$externalCommands = $commands | Where-Object {
      $commandName = $_.CommandElements[0].Extent.Text
      $commandName -notin $functionNames
  } |
  Sort-Object -Property { $_.GetCommandName() } -Unique

2019-03-11发表2022-07-06更新powershell / tip3 分钟读完 (大约501个字)

PowerShell 技能连载 - 从图片中创建彩色 ASCII 艺术

在之前的技能中我们介绍了如何读取任何图片或照片，并将它转换为一个黑白 ASCII 艺术。今天，我们将修改 Convert-ImageToAsciiArt 函数：它输入一个函数并将它转换为彩色的 ASCII 艺术！

像素的亮度值将被转换为合适的 ASCII 字符，并且像素的颜色值将应用到该字符。ASCII 艺术将写入 HTML 文件，因为 HTML 是表示彩色文字的最简单格式。

function Convert-ImageToAsciiArt
{
  param(
    [Parameter(Mandatory)][String]
    $ImagePath,

    [Parameter(Mandatory)][String]
    $OutputHtmlPath,

    [ValidateRange(20,20000)]
    [int]$MaxWidth=80
  )

  ,

  # character height:width ratio
  [float]$ratio = 1.5

  # load drawing functionality
  Add-Type -AssemblyName System.Drawing

  # characters from dark to light
  $characters = &#39;$#H&@*+;:-,. &#39;.ToCharArray()
  $c = $characters.count

  # load image and get image size
  $image = [Drawing.Image]::FromFile($ImagePath)
  [int]$maxheight = $image.Height / ($image.Width / $maxwidth) / $ratio

  # paint image on a bitmap with the desired size
  $bitmap = new-object Drawing.Bitmap($image,$maxwidth,$maxheight)


  # use a string builder to store the characters
  [System.Text.StringBuilder]$sb = "<html><building style=&#39;font-family:""Consolas""&#39;>"


  # take each pixel line...
  for ([int]$y=0; $y -lt $bitmap.Height; $y++) {
    # take each pixel column...
    $null = $sb.Append("<nobr>")
    for ([int]$x=0; $x -lt $bitmap.Width; $x++) {
      # examine pixel
      $color = $bitmap.GetPixel($x,$y)
      $brightness = $color.GetBrightness()
      # choose the character that best matches the
      # pixel brightness
      [int]$offset = [Math]::Floor($brightness*$c)
      $ch = $characters[$offset]
      if (-not $ch) { $ch = $characters[-1] }
      $col = "#{0:x2}{1:x2}{2:x2}" -f $color.r, $color.g, $color.b
      if ($ch -eq &#39; &#39;) { $ch = " "}
      $null = $sb.Append( "<span style=""color:$col""; ""white-space: nowrap;"">$ch</span>")
    }
    # add a new line
    $null = $sb.AppendLine("</nobr><br/>")
  }

  # close html document
  $null = $sb.AppendLine("</building></html>")

  # clean up and return string
  $image.Dispose()

  Set-Content -Path $OutputHtmlPath -Value $sb.ToString() -Encoding UTF8
}

还有以下是如何将一张图片转换为一个漂亮的 ASCII 艺术，并在浏览器VS显示，甚至在彩色打印机中打印出来：

$ImagePath = "C:\someInputPicture.jpg"
$OutPath = "$home\desktop\ASCIIArt.htm"

Convert-ImageToAsciiArt -ImagePath $ImagePath -OutputHtml $OutPath -MaxWidth 150
Invoke-Item -Path $OutPath

可以通过调整 -MaxWidth 来控制细节。如果增加了宽度，那么也必须调整字体大小并增加字符数。对于更小的字符，您可能需要调整这行：

1	[System.Text.StringBuilder]$sb = "<html><building style='font-family:""Consolas""'>"

例如将它改为这行：

1	[System.Text.StringBuilder]$sb = "<html><building style='font-family:""Consolas"";font-size:4px'>"

2019-03-08发表2022-07-06更新powershell / tip3 分钟读完 (大约516个字)

PowerShell 技能连载 - 通过校验位测试原始数据——实际案例

随着 PowerShell 进入物联网世界，有些时候需要处理二进制的传感器数据和古老的校验模型来确保数据的完整性。

这是一个如何用 PowerShell 处理传感器数据并且校验其正确性的真实案例。这里介绍的案例仅适用于特定的用例，但是这里介绍的技术原理对类似的传感器依然有效。

在这个例子中，PowerShell 收到一系列十六进制数据 ($data)。校验码是最后一个字节 (3A)。它的定义是数据报文中所有字节的和。在这个总和中用的是最低有效字节来表示校验位，而且要求比特为反码。听起来很奇怪但是有道理。通过这种方式计算出来的校验和永远只有一个字节。

以下是 PowerShell 处理这些需求的方法，将校验位和计算出来的校验位对比，就可以测试数据的完整性：

$data = '00030028401D2E8D4022C0EE4022C0E64022C0E6418B4ACD419FE7B641A05F0E41A060D041A061C23F0A7CDA3A'

# checksum is last byte
$checksum = [Convert]::ToByte($data.Substring($data.Length-2,2), 16)

# remove checksum from data
$data = $data.Substring(0, $data.Length -2)

# sum up all bytes
$sum = $data -split '(?<=\G.{2})(?=.)' |
  Foreach-Object {$c = 0}{$c+=[Convert]::ToByte($_,16)}{ $c }

# get the least significant byte
$lsb = ([Net.IPAddress]$sum).GetAddressBytes()[0]

# invert bits
$checksumReal = $lsb -bxor 0xFF

# compare
if ($checksum -ne $checksumReal)
{
  throw "Checksum does not match"
}
else
{
  Write-Warning "Checksum ok"
}

今日知识点：

用 [Convert]::ToByte($number, 16) 将十六进制字符串转换为数字。
通过正则表达式，可以很容易地将一个字符流（例如十六进制对）转换为一对一对字符的列表，这样可以计算总和。
通过将一个数字转换为 IPAddress，可以方便地操作不同的字节顺序 (LSB, MSB)。
用 -bxor 求比特位反码。

2019-03-07发表2022-07-06更新powershell / tip2 分钟读完 (大约352个字)

PowerShell 技能连载 - 求比特位反码

有些时候需要求一个数字的比特位反码。最常见的情况是属于某种自定义的算法或计算校验。这引出了一个通用的问题：最简单的实现方法是什么？

“求比特位反码”操作可以通过 -bnot 操作符实现，类似这样：

$number = 76
[Convert]::ToString($number,2)

$newnumber = -bnot $number
[Convert]::ToString($newnumber,2)

不过，结果会显示一个警告：

1001100
11111111111111111111111110110011

这个操作符总是针对 64 位的有符号数。一个更好的方法是使用 -bxor 操作符，并且根据需要颠倒的数据类型提供对应的比特位掩码。对于一个字节，比特位掩码是 0xFF，对于 Int32，比特位掩码是 0xFFFFFFFF。以下是一个求某个字节的比特位反码的示例。我们将一个字符串结果填充至 8 个字符，来确保前导零可见：

$number = 76
[Convert]::ToString([byte]$number,2).PadLeft(8, '0')

$newnumber = $number -bxor 0xFF
[Convert]::ToString($newnumber,2).PadLeft(8, '0')

结果是正确的：

01001100
10110011

今日知识点：

PowerShell 包含了许多二进制操作符，它们都以 -b... 开头。
要求比特位反码，您可以使用 -bnot。如果只要反转某几位，请使用 -bxor 和自定义比特掩码。

2019-03-06发表2022-07-06更新powershell / tip3 分钟读完 (大约449个字)

PowerShell 技能连载 - 计算最高和最低有效字节

数字在内部是以字节的形式存储的。例如一个 Int32 数值使用 4 个字节。有些时候需要将数字分割为字节，例如要以 TODO least significiant 字节顺序计算校验和。

我们创建了一个快速的全览，您也可以将它当作一个基本的数字处理教程。它演示了数字如何对应到字节，并且如何计算最低有效字节 (LSB) 和最高有效字节 (MSB)，以及其它：

function Show-Header([Parameter(ValueFromRemainingArguments)][string]$Text)
{
  $Width=80
  $padLeft = [int]($width / 2) + ($text.Length / 2)
  ''
  $text.PadLeft($padLeft, "=").PadRight($Width, "=")
  ''
}


Show-Header Starting with this number:
$number = 26443007
$number

Show-Header Display the bits for this number:
$bits = [Convert]::ToString($number,2)
$bits

Show-Header Add missing leading zeroes:
# pad the string to its full bit range (32 bits)
$bitsAligned = $bits.PadLeft(32, '0')
$bitsAligned

Show-Header Display the four byte groups
$bitsAligned -split '(?<=\G.{8})(?=.)' -join '-'

Show-Header Get the bytes by conversion to IPAddress object:
$bytes = ([Net.IPAddress]$number).GetAddressBytes()
$bytes

Show-Header Display the bits for the IPAddress bytes:
$bitbytes = $bytes | ForEach-Object { [Convert]::ToString($_, 2).PadLeft(8,'0')}
$bitbytes -join '-'

Show-Header Show the Least Significant Byte LSB:
$bytes[0]

Show-Header Show LSB by turning the 8 bits to the right into a number to verify:
$bits = [Convert]::ToString($number, 2)
# take least significant bits
[Convert]::toByte($bits.Substring($bits.Length-8),2)

Show-Header Show the Most Significant Byte MSB:
$bytes[3]

如您所见，有许多方法可以实现。一个特别聪明的办法是将数字转换为一个 IPAddress。IPAddress 对象有一个好用的 GetAddressBytes() 方法，可以将数字轻松地分割为字节。

结果看起来类似这样：

===========================Starting with this number:===========================

26443007

=======================Display the bits for this number:========================

1100100110111110011111111

===========================Add missing leading Zeroes:==========================

00000001100100110111110011111111

==========================Display the four byte groups==========================

00000001-10010011-01111100-11111111

================Get the bytes by conversion to IPAddress object:================

255
124
147
1

===================Display the bits for the IPAddress bytes:====================

11111111-01111100-10010011-00000001

======================Show the Least Significant Byte LSB:======================

255

======Show LSB by turning the 8 bits to the right into a number to verify:======

255

=======================Show the Most Significant Byte MSB:======================

1

2019-03-05发表2022-07-06更新powershell / tip3 分钟读完 (大约515个字)

PowerShell 技能连载 - 接受不带引号的参数

在前一个技能中，我们介绍了一个能够输入一个字符串并生成完美居中的标题的函数。以下是该函数和它的执行结果：

function Show-Header($Text)
{
  $Width=80
  $padLeft = [int]($width / 2) + ($text.Length / 2)
  $text.PadLeft($padLeft, "=").PadRight($Width, "=")
}


PS> Show-Header Starting
====================================Starting====================================

PS> Show-Header "Processing Input Values"
=============================Processing Input Values============================

如您所见，这个函数工作起来很完美，但是如果该字符串包含空格或其它特殊字符，用户需要用双引号将它包起来。难道不能让这个函数接受没有双引号的字符串，并将所有的输入视为一个参数吗？

这是完全可能的，如下：

这个参数定义了明确的数据类型，例如 [string]，那么 PowerShell 就了解了应当如何处理您的参数。
只能使用单个参数，这样 PowerShell 便知道了所有的输入项都需要转换为该参数。

以下是修改后的函数：

function Show-Header([Parameter(ValueFromRemainingArguments)][string]$Text)
{
  $Width=80
  $padLeft = [int]($width / 2) + ($text.Length / 2)
  $text.PadLeft($padLeft, "=").PadRight($Width, "=")
}

魔力是通过 ValueFromRemainingArguments 属性产生的，用户可以简单地输入文字并切不需要使用双引号：

PS> Show-Header Starting
====================================Starting====================================

PS> Show-Header Processing Input Values
=============================Processing Input Values============================

然欧，有一点需要注意：任何特殊字符，例如圆括号和双引号仍会干扰解析。在这些情况下，您需要像之前那样将字符串用双引号包起来。

今日知识点：

用 ValueFromRemainingArguments 属性使 PowerShell 能够将所有未绑定（额外）的参数分配到该参数上。
使用清晰的数据类型做为参数，这样 PowerShell 知道如何转换含糊的数据。例如，没有 [string] 数据类型的话，如果输入值包含空格，PowerShell 将会为创建一个字符串数组。

2019-03-04发表2022-07-06更新powershell / tip1 分钟读完 (大约209个字)

PowerShell 技能连载 - 创建对齐的标题

在 PowerShell 中常常需要创建报表和日志。以下是一个创建漂亮的居中标题的函数。只需要将 $width 改为期望的宽度：

function Show-Header($Text)
{
  $Width=80
  $padLeft = [int]($width / 2) + ($text.Length / 2)
  $text.PadLeft($padLeft, "=").PadRight($Width, "=")
  }

以下是执行结果：

PS> Show-Header Starting
====================================Starting====================================

PS> Show-Header "Processing Input Values"
=============================Processing Input Values============================

PS> Show-Header "Calculating..."
=================================Calculating...=================================

PS> Show-Header "OK"
=======================================OK=======================================

额外的知识点如下：

使用 PadLeft() 和 PadRight() 来填充（扩展）两端，并且是使用您希望的字符来填充空白。

基于这个知识点，现在可以做许多相关的事情，例如创建一个固定宽度的服务器名称列表：

1,4,12,888 | ForEach-Object { 'Server_' + "$_".PadLeft(8, "0") }

Server_00000001
Server_00000004
Server_00000012
  Server_00000888

2019-03-01发表2022-07-06更新powershell / tip2 分钟读完 (大约243个字)

PowerShell 技能连载 - 计算机名、DNS 名称，和 IP 地址

以下是一个单行的代码，返回您计算机的当前 IP 地址和它的完整 DNS 名：

PS> [System.Net.Dns]::GetHostEntry('')

HostName        Aliases AddressList
--------        ------- -----------
DESKTOP-7AAMJLF {}      {fe80::532:c4e:c409:b987%18, 192.168.2.129}

要检测一台远程的及其，只需要传入远程计算机的名字来代替空白字符串即可：

PS> [System.Net.Dns]::GetHostEntry('microsoft.com')

HostName      Aliases AddressList
--------      ------- -----------
microsoft.com {}      {40.113.200.201, 40.76.4.15, 104.215.148.63, 13.77.161.179...}

如果你只希望获取绑定的 IP 地址列表，请试试以下代码：

PS> [System.Net.Dns]::GetHostEntry('microsoft.com').AddressList.IPAddressToString
40.113.200.201
40.76.4.15
104.215.148.63
13.77.161.179
40.112.72.205

今日知识点：

System.Net.Dns 类包含许多有用的 DNS 相关方法。GetHostEntry() 非常有用，因为它既可以接受计算机名称也可以接受 IP 地址，并返回对应的 DNS 名和 IP 地址。
传入空白字符串可以查看本机的设置。

PowerShell 技能连载 - 检查 Cmdlet 可用性和脚本兼容性（第 3 部分）

PowerShell 技能连载 - 检查 Cmdlet 可用性和脚本兼容性（第 2 部分）

PowerShell 技能连载 - 检查 Cmdlet 可用性和脚本兼容性（第 1 部分）

PowerShell 技能连载 - 从图片中创建彩色 ASCII 艺术

PowerShell 技能连载 - 通过校验位测试原始数据——实际案例

PowerShell 技能连载 - 求比特位反码

PowerShell 技能连载 - 计算最高和最低有效字节

PowerShell 技能连载 - 接受不带引号的参数

PowerShell 技能连载 - 创建对齐的标题

PowerShell 技能连载 - 计算机名、DNS 名称，和 IP 地址

链接

分类

最新文章

归档

标签

订阅更新