2022-02-11发表2022-07-06更新powershell / tip2 分钟读完 (大约244个字)

PowerShell 技能连载 - 计算第几周（第 2 部分）

在上一个技能中，我们解释了如何计算给定日期的日历周。如您所见，这取决于文化和日历设置，并且可能因文化而异。

这就是为什么还有 “ISOWeek” 的原因：它遵守 ISO 8601 并且是标准化的。不幸的是，.NET 中的经典 API 并不总是能计算出正确的 ISOWeek。

这就是为什么微软在 .NET Standard（PowerShell 7 使用的可移植 .NET）和 .NET Framework 5 中添加了一个名为 “ISOWeek” 的全新类。

下面这行代码返回任何日期的 ISOWeek（当在 PowerShell 7 中运行时）：

1 2	PS> [System.Globalization.ISOWeek]::GetWeekOfYear('2022-01-01') 52

在 Windows PowerShell 中运行时，同样的代码会返回红色的异常，因为 Windows PowerShell 基于完整的 .NET Framework，而在当前版本中尚不支持此 API。

2022-02-09发表2022-07-06更新powershell / tip2 分钟读完 (大约225个字)

PowerShell 技能连载 - 计算第几周（第 1 部分）

计算第几周不是一件很容易的事，并且根据文化不同而不同。以下是一个计算任何日期是第几周的方法：

# calculate day of week
# adjust calendar specs to your culture

$Date = [DateTime]'2021-12-31'
$CalendarWeekRule = [System.Globalization.CalendarWeekRule]::FirstDay
$FirstDayOfWeek   = [System.DayOfWeek]::Monday

$week = [System.Globalization.DateTimeFormatInfo]::CurrentInfo.Calendar.GetWeekOfYear( $date, $calendarWeekRule, $firstDayOfWeek )

"$date = week $week"

只需确保您按照当地文化调整了日历的周规则和一周的第一天。

前面的示例使用当前的文化日历。如果您想控制文化，请尝试使用这种方法：

$Date = [DateTime]'2022-12-31'
$CultureName = 'de-de'
$CalendarWeekRule = [System.Globalization.CalendarWeekRule]::FirstDay
$FirstDayOfWeek   = [System.DayOfWeek]::Monday

$culture = [System.Globalization.CultureInfo]::GetCultureInfo($CultureName)
$week = $culture.Calendar.GetWeekOfYear($Date, $CalendarWeekRule, $FirstDayOfWeek)


"$Date = week $week"

在这里，您可以使用 $CultureName 来定义要使用的日历的文化名称。

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

PowerShell 技能连载 - 通过 PowerShell 创建日历电子表格

是否需要计划为您的俱乐部，社区或爱好进行重复的会议吗？当然，有很多在线工具可以帮助您，但如果您想在 Microsoft Excel 中创建日历列表，PowerShell 可以是一个优秀的帮手。

让我们假设您每周三都有一次重复的会议，会议在下午十二点开始，除了每个月的最后一周。

您可以这样使用 PowerShell，而不是将这些日期和时间手动添加到 Excel 表：

# generate calendar for weekly incidents

$startdate = [DateTime]'2022-06-01'
$numberOfWeeks = 52
$result = for ($week = 0; $week -lt $numberOfWeeks; $week ++)
{
  # calculate the real date each week
  $realdate = $startdate + (New-Timespan -days (7*$week))

  # calculate the current month
  $month = $realdate.Month

  # calculate the days in this month
  $daysInMonth = [DateTime]::DaysInMonth($realdate.Year, $realdate.Month)

  # make arbitrary adjustments, i.e. set start time to 12PM by default, but 7PM on the last week of a month

  # are we in the last week of a month?
  if ($realdate.Day -gt ($daysInMonth-7))
  {
    # add 19 hours
    $realdate = $realdate.AddHours(19)
  }
  else
  {
    # add 12 hours
    $realdate = $realdate.AddHours(12)
  }

  # create your Excel sheet layout as a CSV file
  [PSCustomObject]@{
    Start = $realdate
    IsOnline = $false
    Title = ''
    Speaker = ''
    Notes = ''
  }
}


$path = "$env:temp\calendar.csv"
$result | Export-Csv -UseCulture -Path $path -Encoding UTF8 -NoTypeInformation

# open CSV in Excel
Start-Process -FilePath excel -ArgumentList $path

此脚本使用了许多有用的技术：

在循环中使用偏移量来构建日期（在此示例中是 7 天，可以轻松调整成任何其他间隔）
通过计算当前月份的天数来识别“该月的最后一周”，然后根据此计算日期进行调整
在 Microsoft Excel 中生成 CSV 数据和打开 CSV（如果已安装）

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

PowerShell 技能连载 - 打开关闭 Windows 的对话框

以下是打开关闭 Windows 对话框的一行代码：

1	(New-Object -ComObject Shell.Application).ShutdownWindows()

使用此行代码，它变成了名为 “bye” 的新命令：

1	function bye { (New-Object -ComObject Shell.Application).ShutdownWindows() }

如果将此行放在 $profile 中的自动配置文件 (start) 脚本中（可能需要先创建该文件），则完成脚本时，您现在可以简单地输入 “bye” 以关闭您的 Windows 会话。

2022-02-01发表2022-07-06更新powershell / tip3 分钟读完 (大约382个字)

PowerShell 技能连载 - 查看所有模块的细节

powershellgallery.com 是找到新的免费 PowerShell 扩展模块的好地方，可以为您的 PowerShell 添加新的 cmdlet。

但是，在 Web 界面中查看所有模块详细信息可能会有点麻烦。这就是为什么通过 RESTful WebService 检索模块信息可能会有所帮助。

这是一个脚本，它传入 PowerShell Gallery 中托管的（任何）模块的名称。然后，它检索所有详细信息（例如版本历史记录、下载计数、更新日期和发行说明），并以一种使信息易于访问的方式准备它们。特别是，将检索到的基于 XML 的信息转换为简单对象：

# replace module name with any module name hosted
# in the PowerShell Gallery (https://powershellgallery.com)
$ModuleName = 'MicrosoftTeams'

$baseUrl = 'https://www.powershellgallery.com/api/v2/FindPackagesById()?id='
$escaped = [Uri]::EscapeDataString("'$ModuleName'")
$url = $baseUrl + $escaped

# properties to exclude (add or remove as needed)
$blacklist = 'FileList', 'Tags'

$data = Invoke-RestMethod -Uri $url -UseBasicParsing |
ForEach-Object {
  $hash = [Ordered]@{}
  $moduleInfo = $_.Properties
  foreach($_ in $moduleInfo.PSObject.Properties)
  {
    # name of property
    $name = $_.Name
    # if it is in blacklist, skip and continue with next property
    if ($name -in $blacklist) { continue }
# if it is the property "name", then skip
# all remaining (xml default properties)
    if ($name -eq 'Name') { break }

    # if type is "xmlelement", retrieve underlying text value in #text
    if ($_.TypeNameOfValue -eq 'System.Xml.XmlElement')
    {
      $hash[$name] = $moduleInfo.$name.'#text'

      # if a datatype is assigned, try and convert to appropriate type
      if ($moduleInfo.$name.type -like 'Edm.*')
      {
        $typename = $moduleInfo.$name.type.replace('Edm.','')
        $hash[$name] = $hash[$name] -as $typename
      }
    }
    else
    {
      $hash[$name] = $_.Value
    }
  }

  # convert a hash table to object and return it
  [PSCustomObject]$hash
}

$data | Out-GridView

2022-01-28发表2022-07-06更新powershell / tip3 分钟读完 (大约502个字)

PowerShell 技能连载 - 识别主 PowerShell 模块位置

PowerShell 只是一个脚本引擎。其所有 cmdlet 来自外部模块，环境变量 $env:PSModulePath 返回 PowerShell 自动扫描模块的文件夹：

PS> $env:PSModulePath -split ';'
C:\Users\username\Documents\WindowsPowerShell\Modules
C:\Program Files\WindowsPowerShell\Modules
C:\WINDOWS\system32\WindowsPowerShell\v1.0\Modules

同样，Get-Module 查找位于其中一个文件夹中的所有模块和 cmdlet：

1	Get-Module -ListAvailable

当您以专家的身份使用 PowerShell 时，确保所有所需的模块（以及其 cmdlet）都可以使用，将越来越重要。因此，第一步是选择一个好的位置来存储新模块，下一步是良好地部署和更新这些模块。

本地存储模块的最佳位置是代表 “AllUsers” 范围的文件夹。在 Windows 系统上，此文件夹位于 Program Files 中，您需要管理员权限来更改它。

在大型企业中部署和更新模块的最佳方法是使用现有的软件部署基础架构和部署模块及其更新，以及之前识别的 “AllUsers” 文件夹。

该文件夹的路径可能会根据您使用的 PowerShell 版本而异。以下是一个脚本，用于计算所有用户的模块位置的路径：

# determine the primary module location for your PowerShell version
$path = if ('Management.Automation.Platform' -as [Type])
{
  # PowerShell CLR
  if ([Environment]::OSVersion.Platform -like 'Win*' -or $IsWindows) {
    # on Windows
    Join-Path -Path $env:ProgramFiles -ChildPath 'PowerShell'
  }
  else
  {
    # on Non-Windows
    $name = [Management.Automation.Platform]::SelectProductNameForDirectory('SHARED_MODULES')
    Split-Path -Path $name -Parent
  }
}
else
{
  # Windows PowerShell
  Join-Path -Path $env:ProgramFiles -ChildPath "WindowsPowerShell"
}

在 Windows 上，PowerShell 7 和 Windows PowerShell 可以共享一个文件夹，因此如果您不想专门为 PowerShell 7 部署模块，则可以进一步简化脚本：

# determine the primary module location for your PowerShell version
$path = if ([Environment]::OSVersion.Platform -like 'Win*' -or $IsWindows)
{
  # Windows
  Join-Path -Path $env:ProgramFiles -ChildPath "WindowsPowerShell"
}
else
{
  # Non-Windows
  $name = [Management.Automation.Platform]::SelectProductNameForDirectory('SHARED_MODULES')
  Split-Path -Path $name -Parent
}

$path

2022-01-26发表2022-07-06更新powershell / tip1 分钟读完 (大约155个字)

PowerShell 技能连载 - 测试 URL 是否完整

PowerShell 经常基于 API，您不需要深入正则表达式和文本模式。相反，.NET Framework 中可以使用多种专业的测试方法。困难的是找到并知道它们，而不是运行它们和进行测试。

例如，要测试 URL 是否正确，请尝试：

1
2
3

$url = 'powershell.one'
$kind = [UriKind]::Absolute
[Uri]::IsWellFormedUriString($url, $kind)

结果将是 false ，因为 “powershell.one” 不是一个绝对的 URL。在前面添加 “https://“，结果会变为 true。

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

PowerShell 技能连载 - 是否在 Windows PowerShell 中运行（第 2 部分）

在上一个技能中，我们介绍了一个向后兼容的单行代码，能够判断您的脚本是否运行在传统的 Windows PowerShell 环境中，还是运行在新的 PowerShell 7 便携版 shell 中。

如果您使用的是跨平台的 PowerShell 7，那么有一个名为 [Management.Automation.platform] 的新类型，能返回更多的平台信息。Windows PowerShell 尚未包含此类型，因此您可以使用此类型来确定您是否当前正在 Windows PowerShell 上运行。如果没有，则该类型提供了额外的平台信息：

# testing whether type exists
$type = 'Management.Automation.Platform' -as [Type]
$isWPS = $type -eq $null

if ($isWPS)
{
  Write-Warning 'Windows PowerShell'
} else {
  # query all public properties
  $properties = $type.GetProperties().Name
  $properties | ForEach-Object -Begin { $hash = @{} } -Process {
    $hash[$_] = $type::$_
    } -End { $hash }
}

在 Windows PowerShell 上，脚本只会产生警告。在 PowerShell 7 上，它返回一个哈希表，其中包含所有相关平台信息：

Name                           Value
----                           -----
IsStaSupported                 True
IsLinux                        False
IsCoreCLR                      True
IsWindows                      True
IsNanoServer                   False
IsMacOS                        False
IsWindowsDesktop               True
IsIoT                          False

2022-01-20发表2022-07-06更新powershell / tip1 分钟读完 (大约162个字)

PowerShell 技能连载 - 是否在 Windows PowerShell 中运行（第 1 部分）

现在的 PowerShell 可以在各种平台上运行，并且在上一个技能中，我们解释了如何查看脚本运行的操作系统。

如果操作系统是 Windows，您仍然不能知道您的脚本是由内置 Windows PowerShell 还是新的便携式 PowerShell 7 运行。

以下是一种安全和向后兼容的方式，可以了解您的脚本是否在 Windows PowerShell 上运行：

$RunOnWPS = !($PSVersionTable.ContainsKey('PSEdition') -and
                $PSVersionTable.PSEdition -eq 'Core')

"Runs on Windows PowerShell? $RunOnWPS"

2022-01-18发表2022-07-06更新powershell / tip1 分钟读完 (大约202个字)

PowerShell 技能连载 - 决定您的平台

现在的 PowerShell 已是跨平台的，因此即使能在 Windows 服务器上正常使用 Windows PowerShell，您的脚本也有可能在不同的操作系统上停止运行。

如果您的脚本想要知道它正在运行的平台，以向后兼容的方式运行，请尝试这些代码：

$RunOnWindows = (-not (Get-Variable -Name IsWindows -ErrorAction Ignore)) -or $IsWindows
$RunOnLinux = (Get-Variable -Name IsLinux -ErrorAction Ignore) -and $IsLinux
$RunOnMacOS = (Get-Variable -Name IsMacOS -ErrorAction Ignore) -and $IsMacOS

Get-Variable -Name RunOn*

在 Windows 系统上，结果如下所示：

Name                           Value
----                           -----
RunOnLinux                     False
RunOnMacOS                     False
RunOnWindows                   True

您现在可以安全地检查先决条件，并确保您的脚本代码仅在适当的情况下运行。