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                   :

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

PowerShell 技能连载 - 在多台计算机中并行运行命令

假设您已经启用了 PowerShell 远程处理（请看我们之前的技能），那么您可以同时在多台计算机上运行命令。

以下例子演示了这个操作，并且在列表中所有计算机中所有用户的桌面上放置一个文件。警告：这是个很强大的脚本。它将在列表中的所有机器上运行 $code 中的任何代码，假设启用了远程处理，并且您有相应的权限：

# list of computers to connect to
$listOfComputers = 'PC10','TRAIN1','TRAIN2','AD001'
# exclude your own computer
$listOfComputers = $listOfComputers -ne $env:COMPUTERNAME
# code to execute remotely
$code = {
"Hello" | Out-File -FilePath "c:\users\Public\Desktop\result.txt"
}
# invoke code on all machines
Invoke-Command -ScriptBlock $code -ComputerName $listOfComputers -Throttle 1000

例如，如果您将 $code 中的代码替换为 Stop-Computer -Force，所有机器将会被关闭。

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

PowerShell 技能连载 - 通过 PowerShell 远程处理操作远程机器

当您在目标机器上启用了 PowerShell 远程处理，请试试交互式地连接它。以下是您值得尝试的例子。只需要确保将 targetComputerName 替换成您需要连接的目标机器名即可：

PS C:\> Enter-PSSession -ComputerName targetComputerName

[targetComputerName]: PS C:\Users\User12\Documents> $env:COMPUTERNAME
TARGETCOMPUTERNAME

[targetComputerName]: PS C:\Users\User12\Documents> exit

PS C:\> $env:COMPUTERNAME
YOURCOMPUTERNAME

如果连接失败并且报 “Access Denied” 错误，您可能需要使用 -Credential 参数并且使用一个不同的用户账户来登录远程计算机。您可能需要本地管理员特权。

如果连接失败并且报告 RDP 错误，或者如果 WinRM 无法找到目标计算机名，请使用 Test-WSMan 检查连接。如果这无法连接上，请重新检查远程设置。您可能需要像之前的技能中描述的那样，先在目标机器上运行 Enable-PSRemoting。

请不要运行会打开窗口的命令。只能运行产生文本信息的命令。

要离开远程会话，请使用 exit 命令。