2020-05-12发表2022-07-06更新powershell / tip1 分钟读完 (大约216个字)

PowerShell 技能连载 - 创建软件库

Windows 注册表存储已安装的所有软件的名称和详细信息。PowerShell 可以读取该信息，并为您提供完整的软件清单：

# read all child keys (*) from all four locations and do not emit
# errors if one of these keys does not exist
Get-ItemProperty -Path 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*',
                    'HKLM:\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\*',
                    'HKCU:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*',
                    'HKCU:\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\*' -ErrorAction Ignore |
# list only items with the DisplayName
Where-Object DisplayName |
# show these registry values per item
Select-Object -Property DisplayName, DisplayVersion, UninstallString, InstallDate |
# sort by DisplayName
Sort-Object -Property DisplayName

如果您想添加更多信息（例如，软件是 32 位还是 64 位），或者要将代码转换为可重用的新 PowerShell 命令，请在此处阅读更多内容：https://powershell.one/code/5.html。

2020-05-08发表2022-07-06更新powershell / tip6 分钟读完 (大约894个字)

PowerShell 技能连载 - 使 PowerShell 模块保持最新

务必经常检查您的 PowerShell 模块是否为最新。如果您使用的是旧的和过时的模块，则可能会遇到问题，就像平时使用旧的和过时的软件一样。

例如，PowerShellGet 模块提供了诸如 Install-Module 之类的 cmdlet，可让您轻松下载和安装其他 PowerShell 模块，并通过新的命令和功能扩展 PowerShell。

为了了解这一点，下面是一个示例，该示例下载并安装 QRCodeGenerator 模块，该模块会生成各种 QR 代码，例如用于 Twitter 个人资料：

# install new PowerShell module from PowerShell Gallery
PS> Install-Module -Name QRCodeGenerator -Scope CurrentUser

# use one of the newly added commands to create a QR code for Twitter profiles
PS> New-QRCodeTwitter  -ProfileName tobiaspsp -Show

使用智能手机相机扫描创建的 QR 码时，您可以访问 QR 码中编码的 Twitter 个人资料。同样，其他 QR 码类型也可以提供前往某个地点的路线或向您的地址簿添加联系人：

PS> Get-Command -Module QRCodeGenerator -CommandType function

CommandType     Name                          Version    Source
-----------     ----                          -------    ------
Function        New-PSOneQRCodeGeolocation    2.2        QRCodeGenerator
Function        New-PSOneQRCodeTwitter        2.2        QRCodeGenerator
Function        New-PSOneQRCodeVCard          2.2        QRCodeGenerator
Function        New-PSOneQRCodeWifiAccess     2.2        QRCodeGenerator

如果您在新添加的模块上遇到问题，则可能是因为 PowerShellGet 模块已过时。如果您仍在使用古老的 PowerShellGet 版本 1.0.0.1，则可能会遇到讨厌的错误。

当模块仅使用 manifest 文件中的 major 和 minor 版本号时，Install-Module 会将它们安装到具有 3 位数字版本号的子文件夹中。这使已安装的模块不可用。

因此，保持模块最新很重要。PowerShellGet 的最新版本已修复此错误。让我们看一下如何检查和更新模块。

首先，找出您当前使用的模块版本，例如 PowerShellGet：

PS> Get-Module -Name PowerShellGet -ListAvailable


    Directory: C:\Program Files\WindowsPowerShell\Modules


ModuleType Version    Name                                ExportedCommands
---------- -------    ----                                ----------------
Script     2.2.1      PowerShellGet                       {Find-Command, Find-DSCResource, Find-Module...}
Script     1.0.0.1    PowerShellGet                       {Install-Module, Find-Module, Save-Module...}

在此示例中，安装了两个不同版本的 PowerShellGet模块：初始发行版本1.0.0.1和更新版本2.2.1。要找出您使用的版本，请尝试以下操作：

PS> Import-Module -Name PowerShellGet

PS> Get-Module -Name PowerShellGet

ModuleType Version    Name                                ExportedCommands
---------- -------    ----                                ----------------
Script     2.2.1      PowerShellGet                       {Find-Command, Find-DscResource, Find-Module...}

接下来，检查是否有可用的较新版本（这要求该模块通过官方 PowerShell 库提供，但并非对所有模块都适用。如果此处未提供您的模块，则需要检查最初提供该模块的实体）：

PS> Find-Module -Name PowerShellGet

Version Name          Repository Description
------- ----          ---------- -----------
2.2.3   PowerShellGet PSGallery  PowerShell module with commands for discovering, installing, upd...

如果有较新的版本，请先尝试更新模块：

PS> Update-Module -Name PowerShellGet

PS> Get-Module -Name PowerShellGet -ListAvailable

    Directory: C:\Users\tobia\OneDrive\Dokumente\WindowsPowerShell\Modules


ModuleType Version    Name                                ExportedCommands
---------- -------    ----                                -----------
Script     2.2.3      PowerShellGet                       {Find-Command, Find-DSCResource, Find-M...}


    Directory: C:\Program Files\WindowsPowerShell\Modules


ModuleType Version    Name                                ExportedCommands
---------- -------    ----                                ----------------
Script     2.2.1      PowerShellGet                       {Find-Command, Find-DSCResource, Find-M...}
Script     1.0.0.1    PowerShellGet                       {Install-Module, Find-Module, Save-M...}

Update-Module 要求该模块最初是通过 Install-Module 安装的。如果是这样，PowerShell 会知道原始源码库并自动更新该模块。

如果 Update-Module 失败，请尝试使用 -Force 参数重新安装该模块。如果仍然失败，请添加 -SkipPublisherCheck 参数：

1	PS> Install-Module -Name PowerShellGet -Scope CurrentUser -Force -SkipPublisherCheck

要验证成功，请确保已加载最新版本：

PS> Import-Module -Name PowerShellGet -Force -PassThru

ModuleType Version    Name                                ExportedCommands
---------- -------    ----                                ----------------
Script     2.2.3      PowerShellGet                       {Find-Command, Find-DscResource, Find-Mo...

2020-05-06发表2022-07-14更新powershell / tip3 分钟读完 (大约456个字)

PowerShell 技能连载 - 增加新的 PowerShell 命令

PowerShell 只是一个脚本平台，可以增加新命令来扩展。新命令的一个很好的来源是公开的 PowerShell Gallery。您可以访问 [https://powershellgallery.com]（https://powershellgallery.com）上的图形前端，并搜索模块。

PowerShell 带有一个称为 PowerShellGet 的模块，该模块又提供了从 PowerShell 库下载和安装扩展的命令。我们现在就下载并安装免费的命令扩展程序。

当前最受欢迎的通用 PowerShell 命令扩展之一是免费的 Carbon 模块，在过去六周中下载了将近 400 万次。要从 PowerShell 库中安装它，请使用 Install-Module。使用 CurrentUser 范围时，不需要管理员权限：

1	PS> Install-Module -Name Carbon -Scope CurrentUser

首次使用时，Install-Module 会请求下载许可并使用 “nuget“ DLL，该 DLL 负责下载和安装过程。接下来，下载并解压缩请求的模块。由于 PowerShell 库是一个公共存储库，因此要求您同意将材料下载到计算机上。使用 -Force 参数可以跳过此部分。

重要提示：PowerShell Gallery 提供的大多数 PowerShell 模块都是基于脚本的。您需要允许执行脚本否则，您将无法使用基于脚本的模块。如果尚未允许脚本执行，则可以使用以下命令：

1	PS> Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force

要查看新的 PowerShell 命令，请列出添加的模块中包含的命令：

1	PS> Get-Command -Module Carbon \| Out-GridView

这是一个例子：

PS> Get-FileShare

Name   Path                              Description
----   ----                              -----------
ADMIN$ C:\Windows                        Remote Admin
C$     C:\                               Default share
print$ C:\Windows\system32\spool\drivers PrintDrivers

2020-05-04发表2022-07-06更新powershell / tip2 分钟读完 (大约303个字)

PowerShell 技能连载 - 获取 WMI 对象的帮助

WMI 非常强大，但文档不太够。要改变这个情况，已经成立了一个小组并正在编写用于 PowerShell 的 WMI 参考文档：https://powershell.one/wmi

为了轻松查找帮助，可以将 Help() 方法添加到所有WMI和CIM实例对象。只需运行以下代码：

$codeCim = {
  $url = 'https://powershell.one/wmi/{0}/{1}' -f $this.CimSystemProperties.Namespace.Replace("/","\"),
  # add class
  $this.CimSystemProperties.ClassName

  Start-Process -FilePath $url.ToLower()
}
$codeWmi = {
  $url = 'https://powershell.one/wmi/{0}/{1}' -f $this.__Namespace, $this.__Class

  Start-Process -FilePath $url.ToLower()
}

Update-TypeData -TypeName Microsoft.Management.Infrastructure.CimInstance -MemberType ScriptMethod -MemberName Help -Value $codeCim -Force
Update-TypeData -TypeName System.Management.ManagementObject -MemberType ScriptMethod -MemberName Help -Value $codeWmi -Force

现在，当您从 Get-WmiObject 或 Get-CimInstance 检索信息时，每个对象都具有新的 Help() 方法，该方法会自动在浏览器中打开相应的参考页：

PS> $result = Get-WmiObject -Class Win32_Share

PS> $result[0].Help()

PS> $result.Help()



PS> $result = Get-CimInstance -ClassName Win32_StartupCommand

PS> $result.Help()

如果您想参加并获得有用的 WMI 示例代码，请转到相应的参考页面，并通过底部的注释功能添加您的代码。

2020-04-30发表2022-07-06更新powershell / tip1 分钟读完 (大约175个字)

PowerShell 技能连载 - 读取机箱的 SKU

在 Windows 10 和 Server 2016中，WMI 添加了一个新属性，该属性简化了机箱或机壳 SKU 的收集。以下这行代码能够读取 SKU：

PS> Get-CimInstance -ClassName Win32_ComputerSystem | Select-Object -Property Name, ChassisSKUNumber

Name            ChassisSKUNumber
----            ----------------
DESKTOP-8DVNI43 Convertible

SKU 编号仅仅是通用的“可替换编号”（对于笔记本电脑）还是一个独立的编号，取决于制造商和 BIOS 设置。

一个更有希望的类是 Win32_SystemEnclosure，它存在于所有 Windows 版本中：

PS> Get-CimInstance -ClassName Win32_SystemEnclosure | Select-Object -Property Manufacturer, SerialNumber, LockPresent

Manufacturer SerialNumber LockPresent
------------ ------------ -----------
Dell Inc.    4ZKM0Z2            False

2020-04-28发表2022-07-06更新powershell / tip1 分钟读完 (大约220个字)

PowerShell 技能连载 - 管理自动重启

当 Windows 系统崩溃时，通常会立即重新启动。这称为“自动重置功能”，使用此此行代码即可检查您的计算机是否支持此功能：

1	Get-CimInstance -ClassName Win32_ComputerSystem \| Select-Object -Property Name, AutomaticResetCapability

系统是否实际执行自动重启由“AutomaticResetBootOption”控制：

1	Get-CimInstance -ClassName Win32_ComputerSystem \| Select-Object -Property Name, AutomaticResetBootOption

If you own Administrator privileges, you can even change this setting. To turn off automatic reset booting, run this:
如果您拥有管理员特权，甚至可以更改此设置。要关闭自动重置启动，请运行以下命令：

1	Set-CimInstance -Query 'Select * From Win32_ComputerSystem' -Property @{AutomaticResetBootOption=$false}

有关 WMI 类 Win32_ComputerSystem 的更多信息，请访问http://powershell.one/wmi/root/cimv2/win32_computersystem。

2020-04-24发表2022-07-06更新powershell / tip2 分钟读完 (大约233个字)

PowerShell 技能连载 - 使用自定义的验证器属性

从 PowerShell 5开始，您可以创建自己的属性，即自定义验证程序。它们可以应用于变量（和参数），并且一旦分配的值与验证程序不匹配，就会引发异常。

这是一个路径验证器的示例。将其应用于变量时，只能将有效文件路径应用于该变量：

class ValidatePathExistsAttribute : System.Management.Automation.ValidateArgumentsAttribute
{
    # the value to be checked surfaces in $path and must be of type [object]
    [void]Validate([object]$path, [System.Management.Automation.EngineIntrinsics]$engineIntrinsics)
    {
        # if anything is wrong with the value, throw an exception
        if([string]::IsNullOrWhiteSpace($path))
        {
            Throw [System.ArgumentNullException]::new()
        }
        if(-not (Test-Path -Path $path))
        {
            Throw [System.IO.FileNotFoundException]::new()
        }

        # if NO exception was thrown, the value is accepted
    }
}
#endregion


[ValidatePathExists()][string]$Path = "c:\windows"
$Path = "c:\test123"

当您分配不存在的路径时，PowerShell都将不分配它，而是保留现有值。

2020-04-22发表2022-07-06更新powershell / tip2 分钟读完 (大约324个字)

PowerShell 技能连载 - 检测是否连接到计费的 WLAN

是否曾经需要知道您当前是否已连接到计费的网络？这是一种快速的检查方法：

function Test-WlanMetered
{
  [void][Windows.Networking.Connectivity.NetworkInformation, Windows, ContentType = WindowsRuntime]
  $cost = [Windows.Networking.Connectivity.NetworkInformation]::GetInternetConnectionProfile().GetConnectionCost()
  $cost.ApproachingDataLimit -or $cost.OverDataLimit -or $cost.Roaming -or $cost.BackgroundDataUsageRestricted -or ($cost.NetworkCostType -ne "Unrestricted")
}

它使用一个 UWP API 返回有关网络状态的大量信息，包括有关网络是否计费的信息。

如果您使用的是较旧的 Windows 平台，则以下是替代的代码，该代码使用好用的旧版 “netsh“ 命令行工具并提取所需的信息。请注意，字符串操作（下面的代码广泛使用）容易出错，可能需要进行调整。

同时，以下代码很好地说明了如果手头没有适当的面向对象的 API 可调用，那么 PowerShell 中的通用字符串操作工具如何可以用作最后的保障：

function Test-WlanMetered
{
  $wlan = (netsh wlan show interfaces | select-string "SSID" | select-string -NotMatch "BSSID")
  if ($wlan) {
    $ssid = (($wlan) -split ":")[1].Trim() -replace '"'
    $cost = ((netsh wlan show profiles $ssid | select-string "Cost|Kosten") -split ":")[2].Trim() -replace '"'

    return ($cost -ne "unrestricted" -and $cost -ne "Uneingeschränkt" -and $cost -ne 'Uneingeschr"nkt')
  }
  else { $false }
}

2020-04-20发表2022-07-06更新powershell / tip2 分钟读完 (大约323个字)

PowerShell 技能连载 - 使用 WMI 实例路径（第 2 部分）

在上一个技能中，我们演示了了新的 Get-CimInstance 命令缺少 Get-WmiObject 能够返回的重要的 “__Path“ 属性。现在让我们将此属性添加回 Get-CimInstance 中。

Get-CimInstance 返回的每个实例的类型均为 [Microsoft.Management.Infrastructure.CimInstance] 类型，因此可以用 Update-TypeData 向该类型添加新属性：

$code = {
    # get key properties
    $keys = $this.psbase.CimClass.CimClassProperties.Where{$_.Qualifiers.Name -eq 'Key'}.Name
    $pairs = foreach($key in $keys)
    {
    '{0}="{1}"' -f $key, $this.$key
    }
    # add server name
    $path = '\\{0}\{1}:{2}.{3}' -f $this.CimSystemProperties.ServerName.ToUpper(),
    # add namespace
    $this.CimSystemProperties.Namespace.Replace("/","\"),
    # add class
    $this.CimSystemProperties.ClassName,
    # add key properties
    ($pairs -join ',')

    return $path
}

Update-TypeData -TypeName Microsoft.Management.Infrastructure.CimInstance -MemberType ScriptProperty -MemberName __Path -Value $code -Force

运行此代码后，所有 CIM 实例都将再次具有 __Path 属性。它略有不同，因为“新的” __Path 属性引用了所有键值。对于我们测试的所有用例，这都没有什么不同：

PS> $old = Get-WmiObject -Class Win32_BIOS

PS> $new = Get-CimInstance -ClassName Win32_BIOS


PS> $old.__PATH
\\DESKTOP-8DVNI43\root\cimv2:Win32_BIOS.Name="1.0.13",SoftwareElementID="1.0.13",SoftwareElementState=3,TargetOperatingSystem=0,Version="DELL   - 20170001"

PS> $new.__Path
\\DESKTOP-8DVNI43\root\cimv2:Win32_BIOS.Name="1.0.13",SoftwareElementID="1.0.13",SoftwareElementState="3",TargetOperatingSystem="0",Version="DELL   - 20170001"


PS> [wmi]($old.__Path)

SMBIOSBIOSVersion : 1.0.13
Manufacturer      : Dell Inc.
Name              : 1.0.13
SerialNumber      : 4ZKM0Z2
Version           : DELL   - 20170001

PS> [wmi]($new.__Path)

SMBIOSBIOSVersion : 1.0.13
Manufacturer      : Dell Inc.
Name              : 1.0.13
SerialNumber      : 4ZKM0Z2
Version           : DELL   - 20170001

2020-04-16发表2022-07-06更新powershell / tip3 分钟读完 (大约451个字)

PowerShell 技能连载 - 使用 WMI 实例路径（第 1 部分）

通常，最好远离旧的和过时的 Get-WmiObject 命令，而使用像 Get-CimInstance 这样的现代且更快的 CIM 命令。在大多数情况下，它们的效果几乎相同。

但是，在某些领域，新的 CIM 命令缺少信息。最重要的领域之一是 Get-WmiObject 返回的任何对象都可以使用的属性 “__Path“。使用 Get-CimInstance 时，会丢失这个属性。

此路径是 WMI 实例的唯一路径。请看一下——此命令列出了 Win32_Share 的所有实例，并将 WMI 路径返回给这些实例：

PS> Get-WmiObject -Class Win32_Share | Select-Object -ExpandProperty __Path
\\DESKTOP-8DVNI43\root\cimv2:Win32_Share.Name="ADMIN$"
\\DESKTOP-8DVNI43\root\cimv2:Win32_Share.Name="C$"
\\DESKTOP-8DVNI43\root\cimv2:Win32_Share.Name="HP Universal Printing PCL 6"
\\DESKTOP-8DVNI43\root\cimv2:Win32_Share.Name="IPC$"
\\DESKTOP-8DVNI43\root\cimv2:Win32_Share.Name="OKI PCL6 Class Driver 2"
\\DESKTOP-8DVNI43\root\cimv2:Win32_Share.Name="print$"

一旦知道实例的路径，就可以随时通过 [wmi] 类型轻松访问它：

PS> [wmi]'\\DESKTOP-8DVNI43\root\cimv2:Win32_Share.Name="HP Universal Printing PCL 6"'

Name                        Path                      Description
----                        ----                      -----------
HP Universal Printing PCL 6 S/W Laser HP,LocalsplOnly S/W Laser HP

这非常有用，您可以使用现有的 WMI 路径或构造自己的 WMI 路径。例如，要访问其他服务器上的 C$ 共享，只需查看路径即可立即确定需要更改的部分：

\\SERVER12345\root\cimv2:Win32_Share.Name="C$"

__Path 属性也使类似这样的“WMI 浏览器”成为可能：

# get all WMI instances
Get-WmiObject -Class CIM_LogicalDevice |
    # display propertes
    Select-Object -Property __Class, Name, Description, __Path |
    # let user select some
    Out-GridView -Title 'Select one or more (hold CTRL)' -PassThru |
    # retrieve the full selected instance by path
    ForEach-Object {
        [wmi]$_.__Path | Select-Object * | Out-Default
    }