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

PowerShell 技能连载 - 转换数字字符串

在 PowerShell 中转换一个包含数字的字符串非常简单：

PS C:\> [double]"77.234"
77,234

PS C:\>

不过，如果字符串包含的不只是纯数字，那么就比较有挑战性了。例如，您需要转换一个类似 “2763MB” 的字符串，PowerShell 无法自动将它转换为一个数字。这时候您需要一个类似这样的转换函数：

function Convert-MBToByte($MBString)
{
    $number = $MBString.Substring(0, $MBString.Length-2)
    1MB * $number
}

Convert-MBToByte -MBString '2433MB'

或者如果它是一个合法的 PowerShell 代码格式，您可以试着让 PowerShell 来做转换：

PS C:\> Invoke-Expression -Command '2615MB'
2742026240

PS C:\>

然而，不推荐使用 Invoke-Expression，因为它会带来安全风险。例如用户能够改变命令执行的表达式，类似 SQL 注入攻击。

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

PowerShell 技能连载 - 使用缺省参数值

您可能听说过 PowerShell 的缺省参数值和 $PSDefaultParameterValues。当您将一个哈希表赋给这个特殊的变量，则哈希表的键定义了命令和影响的参数，而值定对应新的缺省值。

请看这个例子：

1
2
3

$PSDefaultParameterValues = @{
    '*:ComputerName' = 'testserver1'
}

这将会把所有命令 (*) 的 -ComputerName 设置为新的缺省值 “testserver1”。当您调用一个命令，且满足以下两个条件 (a) 有一个名为 ComputerName 的参数 (b) 没有显式地赋值给这个参数时，将会使用缺省值。

这对 PowerShell 函数也有效，然而只对 “Advanced Functions” 有效，对 “Simple Functions” 无效。

要验证区别，请按上述介绍定义 $PSDefaultParameterValues，然后运行这段代码：

function testSimple
{
    param($Computername)

    "Result Simple: $Computername"
}

function testAdvanced
{
    [CmdletBinding()]
    param($Computername)

    "Result Advanced: $Computername"
}


testSimple

testAdvanced

如您所见，只有 testAdvanced 函数应用了缺省参数。”Advanced Functions” 至少要定义一个参数属性，例如 [CmdletBinding()] 或 [Parameter(Mandatory)]。

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

PowerShell 技能连载 - 正确地导入 Excel 的 CSV 文件

如果您导出一个 Excel 工作表到 CSV 文件中，并且希望将这个文件导入 PowerShell，以下是实现方法：

1
2
3

$path = 'D:\sampledata.csv'

Import-Csv -Path $path -UseCulture -Encoding Default

重要的参数有 -UseCulture（自动使用和 Excel 在您系统中所使用一致的分隔符）和 -Encoding Default（只有使用此设置，所有特殊字符才能保持原样）。

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

PowerShell 技能连载 - 在 PowerShell 函数中支持风险缓解

当一个 PowerShell 函数进行一个可能有风险的系统变更时，推荐使用 -WhatIf 和 -Configm 风险缓解参数。以下是基本的需求：

function Test-WhatIf
{
    [CmdletBinding(SupportsShouldProcess,ConfirmImpact='Low',HelpUri='http://www.myhelp.com')]
    param()



    if ($PSCmdlet.ShouldProcess($env:COMPUTERNAME,"Say 'Hello'"))
    {
        "I am executing..."
    }
    else
    {
        "I am simulating..."
    }

}

当运行这个函数时，PowerShell 会遵从 -WhatIf 和 -Confirm 参数设置：

PS C:\> Test-WhatIf -WhatIf
What if: Performing the operation "Say 'Hello'" on target "PC10".
I am simulating...

PS C:\> Test-WhatIf
I am executing...

PS C:\>

这个函数还定义了一个 ConfirmImpact 属性，它的值可以是 Low、Medium 或 High，表示这个函数的操作引起的改变有多严重。

当 ConfirmImpact 的值大于或等于 $ConfirmPreference 变量中定义的值时，PowerShell 自动向用户显示一个确认信息：

PS C:\> $ConfirmPreference = "Low"

PS C:\> Test-WhatIf
I am executing...


Confirmation
Do you really want to perform this action?
...
I am simulating...

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

PowerShell 技能连载 - 按数据类型绑定参数

PowerShell 可以根据数据类型匹配自动地绑定参数。以下是一个体现该特性的示例

function Test-Binding
{
    [CmdletBinding(DefaultParameterSetName='Date')]
    param
    (
        [Parameter(ParameterSetName='Integer', Position=0, Mandatory=$true)]
        [int]
        $Id,

        [Parameter(ParameterSetName='String', Position=0, Mandatory=$true)]
        [string]
        $Name,

        [Parameter(ParameterSetName='Date', Position=0, Mandatory=$true)]
        [datetime]
        $Date
    )

    $chosenParameterSet = $PSCmdlet.ParameterSetName
    Switch ($chosenParameterSet)
    {
        'Integer' { 'User has chosen Integer' }
        'String'  { 'User has chosen String' }
        'Date'    { 'User has chosen Date' }
    }

    [PSCustomObject]@{
        Integer = $Id
        String = $Name
        Date = $Date
    }
}

现在用户可以测试 Test-Binding 并且提交参数：

PS C:\> Test-Binding "Hello"
User has chosen String

Integer String Date
------- ------ ----
        0 Hello



PS C:\> Test-Binding 12
User has chosen Integer

Integer String Date
------- ------ ----
        12



PS C:\> Test-Binding (Get-Date)
User has chosen Date

Integer String Date
------- ------ ----
        0        11/21/2017 11:44:33 AM

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

PowerShell 技能连载 - 删除环境变量

在前一个技能中我们解释了如何在所有可用的范围内设置环境变量的方法。但是如何移除环境变量呢？

巧合地，您可以用完全相同的方法做这件事情，只需要将一个空字符串赋给该变量。然而，前一个技能中的函数中的 -VariableValue 参数不能接受空字符串：

function Set-EnvironmentVariable
{
    [CmdletBinding()]
    param
    (
        [Parameter(Mandatory)][String]
        $VariableName,

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

        [Parameter(Mandatory)][EnvironmentVariableTarget]
        $Target
    )

    [Environment]::SetEnvironmentVariable($VariableName, $VariableValue, $Target)
}

当您尝试着赋值空字符串时，将会收到这样的提示：

1
2
3

PS C:\>  Set-EnvironmentVariable -VariableName test -VariableValue "" -Target  User
Set-EnvironmentVariable  : Cannot bind Argument to Parameter "VariableValue" because it is an  empty string.
...

这是因为当您将一个参数声明为 “Mandatory”，PowerShell 缺省情况下将拒绝空字符串和 null 值。

您可以将 VariableValue 参数设为可选的，但是这样当您调用该函数不传该参数时，PowerShell 将不再提示。如何使一个必选参数能接受 null 和空字符串呢？

只要稍微改一下，加上 [AllowNull()] 和/或 [AllowEmptyString()] 以上函数就可以支持删除环境变量：

function Set-EnvironmentVariable
{
    [CmdletBinding()]
    param
    (
        [Parameter(Mandatory)][String]
        $VariableName,

        [Parameter(Mandatory)][String]
        [AllowEmptyString()]
        $VariableValue,

        [Parameter(Mandatory)][EnvironmentVariableTarget]
        $Target
    )

    [Environment]::SetEnvironmentVariable($VariableName, $VariableValue, $Target)
}

以下是删除 “Test” 环境变量的方法：

1	PS C:\> Set-EnvironmentVariable -VariableName test -VariableValue "" -Target User

2017-12-29发表2022-07-06更新powershell / tip2 分钟读完 (大约313个字)

PowerShell 技能连载 - 设置环境变量

有些时候您会见到一些脚本使用 Select-Object 向现有的对象附加信息，类似以下代码：

Get-Process |
    Select-Object -Property *, Sender|
    ForEach-Object {
        $_.Sender = $env:COMPUTERNAME
        $_
    }

它可以工作，但是 Select-Object 创建了一个完整的对象拷贝，所以这种方法速度很慢而且改变了对象的类型。您可能注意到了 PowerShell 不再使用正常的表格方式输出进程对象，也是因为这个原因。

如果您想设置环境变量，env: 驱动器只能修改进程级别的环境变量。要设置用户或者机器级别的环境变量，请试试这个函数：

function Set-EnvironmentVariable
{
    [CmdletBinding()]
    param
    (
        [Parameter(Mandatory)][String]
        $VariableName,

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

        [Parameter(Mandatory)][EnvironmentVariableTarget]
        $Target
    )

    [Environment]::SetEnvironmentVariable($VariableName, $VariableValue, $Target)
}

请注意 $Target 变量如何使用特殊的数据类型 “EnvironmentVariableTarget” ，当您在 PowerShell ISE 或其它带有 IntelliSense 功能的编辑器中，-Target 参数的可选项有 “Process”、”User” 和 “Machine”。

以下是如何在用户级别创建名为 “Test”，值为 12 的环境变量的方法：

1
2
3

PS C:\> Set-EnvironmentVariable -VariableName test -VariableValue 12 -Target User

PS C:\>

2017-12-28发表2022-07-06更新powershell / tip1 分钟读完 (大约184个字)

PowerShell 技能连载 - 在剪贴板中附加内容

PowerShell 5 带来了新的将文本复制到剪贴板，以及取出剪贴板文本的 cmdlet：Set-Clipboard 和 Get-Clipboard。

Set-Clipboard 也支持 -Append 参数，它可以向剪贴板尾部附加文本。这可以成为一种新奇且有用的记录脚本行为的方法：

Set-ClipBoard "Starting at $(Get-Date)"
1..30 |
  ForEach-Object {
    Set-ClipBoard -Append "Iteration $_"
    $wait = Get-Random -Minimum 1 -Maximum 5
    Set-ClipBoard -Append "Waiting $wait seconds"
    Start-Sleep -Seconds $wait
    "Processing $_"

  }

这个脚本片段使用 Set-Clipboard 将信息粘贴至剪贴板中。脚本运行后，您可以将剪贴板内容粘贴至剪贴板来查看脚本输出的日志。

2017-12-27发表2022-07-06更新powershell / tip2 分钟读完 (大约249个字)

PowerShell 技能连载 - 删除用户配置文件

当一个用户登录计算机时，将创建一套用户配置文件。在前一个技能中我们介绍了如何用 PowerShell 转储计算机中的用户配置文件列表。

如果您想删除一个用户账户，PowerShell 可以帮您清除。以下是使用方法：

首先，调整 $domain 和 $username 变量指向您想删除的用户配置文件。然后，在 PowerShell 中以管理员特权运行以下代码：

#requires -RunAsAdministrator

$domain = 'ccie'
$username = 'user01'

# get user SID
$sid = (New-Object Security.Principal.NTAccount($domain, $username)).Translate([Security.Principal.SecurityIdentifier]).Value

Get-WmiObject -ClassName Win32_UserProfile -Filter "SID='$sid'" |
  ForEach-Object {
    $_.Delete()
  }

第一部分将用户名转换为 SID 并且用它来指定用户配置文件。WMI 的 Delete() 方法删除所有用户配置文件。注意：您将丢失删除的用户配置文件中的所有数据。

2017-12-26发表2022-07-06更新powershell / tip2 分钟读完 (大约348个字)

PowerShell 技能连载 - 管理用户配置文件

要转储一台机子上用户配置文件的原始列表，请使用这行代码：

1	Get-CimInstance -Class Win32_UserProfile \| Out-GridView

您将会获得所有用户配置文件的所有详细信息。用户名可以在 SID 属性中找到，但它是以 SID 的格式表示。要获得真实的用户名，需要将 SID 转换。这段代码创建一个以真实用户名为字段名的哈希表：

$userProfiles = Get-CimInstance -Class Win32_UserProfile |
    # add property "UserName" that translates SID to username
    Add-Member -MemberType ScriptProperty -Name UserName -Value {
    ([Security.Principal.SecurityIdentifier]$this.SID).Translate([Security.Principal.NTAccount]).Value
    } -PassThru |
    # create a hash table that uses "Username" as key
    Group-Object -Property UserName -AsHashTable -AsString

现在可以轻松地转储机器上所有带用户配置文件的用户列表了：

PS C:\> $userProfiles.Keys | Sort-Object
MYDOMAIN\Administrator
MYDOMAIN\User01
MYDOMAIN\User02
MYDOMAIN\User03
MYDOMAIN\User12
NT AUTHORITY\LOCAL SERVICE
NT AUTHORITY\NETWORK SERVICE
NT AUTHORITY\SYSTEM
PC10\User

要获取某个用户配置文件的详细信息，请访问哈希表的字段：

PS C:\> $userProfiles["MYDOMAIN\User01"]


UserName                         : MYDOMAIN\User01
AppDataRoaming                   : Win32_FolderRedirectionHealth
Contacts                         : Win32_FolderRedirectionHealth
Desktop                          : Win32_FolderRedirectionHealth
Documents                        : Win32_FolderRedirectionHealth
Downloads                        : Win32_FolderRedirectionHealth
Favorites                        : Win32_FolderRedirectionHealth
HealthStatus                     : 3
LastAttemptedProfileDownloadTime :
LastAttemptedProfileUploadTime   :
LastBackgroundRegistryUploadTime :
LastDownloadTime                 :
LastUploadTime                   :
LastUseTime                      :
Links                            : Win32_FolderRedirectionHealth
Loaded                           : False
LocalPath                        : C:\Users\User01
Music                            : Win32_FolderRedirectionHealth
Pictures                         : Win32_FolderRedirectionHealth
RefCount                         :
RoamingConfigured                : False
RoamingPath                      :
RoamingPreference                :
SavedGames                       : Win32_FolderRedirectionHealth
Searches                         : Win32_FolderRedirectionHealth
SID                              : S-1-5-21-3860347202-3037956370-3782488958-1604
Special                          : False
StartMenu                        : Win32_FolderRedirectionHealth
Status                           : 0
Videos                           : Win32_FolderRedirectionHealth
PSComputerName                   :