在 PowerShell 中设置变量的快速指南

变量是任何编程语言的基础。 PowerShell 也不例外。变量允许您存储数据、稍后引用它，甚至可以在脚本和函数之间传递它。简而言之，它们增强了您的 PowerShell 代码。了解何时以及如何声明和初始化变量是编写干净、模块化的 PowerShell 脚本的关键。 PowerShell 提供了一种简单而强大的方法来使用 Set-Variable cmdlet 创建和管理变量。对于任何想要开始使用 PowerShell 脚本和命令行自动化的人来说，了解如何使用 Set-Variable 是关键。

在这篇文章中，我将介绍您需要了解的有关在 PowerShell 中设置变量的所有信息。你将学到：

• 初始化变量的基本语法
• 分配值和对象的不同方式
• 何时使用简单赋值与 Set-Variable
• 如何设置具有特定范围的变量
• 要避免的常见陷阱
• 有效使用变量的最佳实践

无论您是 PowerShell 新手还是有一定经验，本指南都将帮助您将各种技能提升到一个新的水平。因此，请继续阅读，了解如何像专业人士一样声明、设置和使用变量！

PowerShell 变量简介

变量是 PowerShell 脚本的关键组件，允许您存储在整个脚本中使用的数据。在 PowerShell 中使用变量可以让您有效地存储和操作数据，使您的 PowerShell 脚本更加动态和灵活。通过为变量赋值，您可以在整个代码中重复使用它们，从而节省时间和资源。 PowerShell 变量有三种类型：标量、数组和哈希表。标量变量存储单个值，而数组变量存储多个值，哈希表变量存储键值对。

PowerShell 允许使用不同类型的变量，包括字符串、整数、数组等等。此外，还有 PowerShell 创建的自动变量、用户首选项的首选项变量以及系统级信息的环境变量。

了解 Set-Variable Cmdlet

Set-Variable cmdlet 是一个内置的 PowerShell 命令，允许您创建新变量或更改现有变量的值，并控制变量的范围和可见性。当您需要为变量分配特定值或更改 PowerShell 中变量的现有值时，此 cmdlet 特别有用。 Set-Variable cmdlet 的语法是：

Set-Variable 
[-Name] <String> 
[[-Value] <Object>] 
[-Scope <String>] 
[-Option {None | ReadOnly | Constant | Private | AllScope}]
[-Force]
[-PassThru]
[-Visibility {Public | Private}] 
[-Include <String[]>]
[-Exclude <String[]>] 
[-Description <String>] 
[-WhatIf] [-Confirm] [<CommonParameters>]

以下是 PowerShell 中 Set-Variable cmdlet 的一些重要参数的列表：

指定变量的名称。 cmdlet 必需的。

指定分配给变量的值。

定义变量的范围（例如全局、本地、脚本）。

设置变量的附加属性（例如，只读、私有）。

强制命令覆盖现有的只读变量。

添加变量的描述。

设置变量的可见性（公共或私有）。

在 PowerShell 中使用 Set-Variable 进行赋值

Set-Variable cmdlet 使用以下语法在 PowerShell 中设置变量。它允许您使用更明确的语法为变量分配值。

Set-Variable -Name <variable-Name> -Value <variable-value>

要更改现有变量的值，请将变量名称传递给 -Name 参数，将值传递给 -value 参数。例如，要将 $myVar 的值更改为 20，您可以使用以下命令：

Set-Variable -Name myVar -Value 20

这将用“20”覆盖 $myVar 中存储的当前值。您还可以将变量传递给 -Value 参数来设置另一个变量的值：

$var1 = "First Value" 
Set-Variable -Name var2 -Value $var1

现在 $var2 包含来自 $var1 的值。

如果变量不存在会发生什么？

如果您尝试更改不存在的变量的值，PowerShell 将自动为您创建它。例如，这会创建一个新变量 $myNewVar 并将值设置为“新变量值”，即使 $myNewVar 之前不存在：

Set-Variable -Name myNewVar -Value "New variable value"

这对于您想要更改值但不确定变量是否已存在的情况非常有用。

使用赋值运算符在 PowerShell 中设置变量

在 PowerShell 中设置变量的最简单方法是使用赋值运算符：在 PowerShell 中，使用“$”符号后跟变量名称和赋值运算符 (=) 创建变量并为其赋值。例如，要将值“123”分配给名为“myVar”的变量，您可以使用以下命令：

$myVar = 123

要在一行中设置多个变量，请用分号分隔它们：

$ComputerName = "Server01"; $UserName = "jdoe"

分配后，您只需引用变量的名称即可访问变量的值。要显示变量的值，您可以使用 Write-Output cmdlet：

Write-Output $myVar

您还可以使用 Write-Host cmdlet 来显示变量的值：

Write-Host "The value of myVar is: $myVar"

我应该使用 Set-Variable 还是 $myVar=“value”？

在 PowerShell 中，您经常会看到只需执行以下操作即可创建变量并为其赋值：

$myVar = "Hello"

那么什么时候应该使用 Set-Variable 而不是这种基本方法呢？主要区别是 Set-Variable 允许您在创建变量时设置其他选项，例如范围。它还使您能够更改现有变量的值。对于只想创建变量并分配值的简单情况，使用 $myVar="value" 效果很好。总的来说，Set-Variable 提供了更多的控制。

虽然=运算符是为变量赋值的最常用方法，但您还可以使用 += 和 -= 运算符来递增或递减变量等。

在 PowerShell 中设置变量的示例

在 PowerShell 中设置变量可以通过多种方式完成。这里有一些例子：

示例 1：将字符串值分配给变量

$myString = "Hello, PowerShell!"

示例 2：为变量分配数值

$myNumber = 42

示例 3：将命令的输出分配给变量

$myOutput = Get-Process

示例 4：创建数组变量

Set-Variable cmdlet 还允许您创建数组和哈希表数据结构。您可以定义一个数组变量：

Set-Variable -Name myArray -Value 1,2,3,4

现在 $myArray 包含一个数组。这提供了一种在 PowerShell 中根据需要创建对象的快速方法。

示例 5：分配哈希表变量

$Settings = @{
  ComputerName = "Server01"
  UserName = "jdoe"
  ErrorActionPreference = "Stop"
}

#Another way
New-Variable -Name myHashTable -Value @{Key1="Value1";Key2="Value2"}

设置变量的数据类型

默认情况下，PowerShell 变量是无类型的，可以包含任何类型的数据。但是，通过设置数据类型，可以强制变量只能保存该特定类型的值。在PowerShell中设置变量的数据类型的语法如下：

[data_type]$VariableName = value

以下是一些示例，演示如何设置各种变量的数据类型。

[int]$myInt = 5
[string]$myString = "Hello, World!"
[bool]$myBool = $true
[datetime]$myDate = Get-Date

当您需要 int、string 或其他特定数据类型时，这非常有用。要获取变量的数据类型，请使用：$Variable.GetType().Name

在 PowerShell 中列出变量

要列出 PowerShell 中的所有变量，您可以使用“Get-Variable”cmdlet。例如：

Get-Variable

这将显示当前在 PowerShell 会话中定义的所有变量的列表。您还可以使用内置的PowerShell驱动器“Variable:”来获取所有变量。

Set-Location Variable:

Dir

要检索特定变量的值，可以使用前面带有“$”符号的变量名称。例如：

$myVariable

这将显示变量“myVariable”中存储的值。

在 PowerShell 中设置变量的范围

变量的作用域是指该变量可见且可以使用的上下文。 PowerShell 中的变量可分为本地变量、全局变量或特定于脚本的变量。默认情况下，创建的变量具有本地作用域，这意味着它仅在 PowerShell 会话的当前作用域中可用。

范围决定变量的可见性和生命周期。以下是使用 Set-Variable 显式配置变量范围的一些示例。

可用范围有：

• 全球 - 随处可用
• 本地 - 仅在当前范围或函数中可用
• 脚本 - 仅在当前脚本中可用
• 私有 - 仅在当前作用域和嵌套在其中的作用域中可用

默认情况下，Set-Variable 创建一个具有局部作用域的变量。这意味着它仅在当前范围内可用。您可以使用 -Scope 参数来更改此设置：

创建私有变量

私有作用域可防止变量在定义作用域之外被覆盖或更改。这可以保护该特定范围内变量值的完整性。私有变量通常在函数内部使用，用于临时存储函数退出后不希望保留的数据。

Set-Variable -Name myPrivate -Value 1 -Scope Private

了解范围很重要，尤其是在编写调用函数或包含高级逻辑的 PowerShell 脚本时。

设置变量的可见性：

默认情况下，变量是公共的。私有变量只能由具有所需权限的脚本访问，但它们对用户不可见。

Set-Variable -Name "myHiddenVar" -Visibility Private

具有“私有”可见性的变量只能在其定义的范围内访问和更改。即使您位于子作用域内，您也无法从父作用域访问私有变量。这与 -Scope 参数不同，后者确定变量存在的位置； -Visibility 参数控制创建后如何与之交互。

了解公共变量与私有变量

公共变量：不带任何作用域修饰符声明的变量默认为公共变量。公共变量在当前作用域和子作用域中的任何地方都可以访问。例如：

$myVar = "Hello"

私有变量：使用 private 作用域修饰符声明的变量是私有的。私有变量只能在当前作用域中访问，不能在任何子作用域中访问。例如：

$private:myPrivateVar = "Private"

或者隐式使用：

function MyFunction {
    $MyPrivateVariable = "I am private within MyFunction."
}

所以，总而言之：

• 公共：可在当前作用域和子作用域中访问
• private：仅在当前范围内可访问
• 使用 Get-Variable 从子作用域访问私有变量

PowerShell 中的全局变量

默认情况下，PowerShell 中的变量是定义它们的范围的本地变量。但是，您可以创建可从脚本内的任何范围访问的全局变量。要创建全局变量，请使用 New-Variable cmdlet，并将 -Scope 参数设置为 Global：

New-Variable -Name myGlobalVar -Value "Hello, world!" -Scope Global

您还可以使用“$global:VariableName”范围标识符声明全局变量。

$global:username = "Admin"

要从脚本中的任何范围访问全局变量，您可以使用 $Global: 前缀：

Write-Host $Global:myGlobalVar

如何将变量设置为只读？

有时，您可能想要创建设置后无法更改的只读变量。当您想要保护变量中存储的数据的完整性时，这会很有用。要创建只读变量，您可以使用 Set-Variable 的 -Option 参数，并将值设置为“ReadOnly”。这是一个例子：

Set-Variable -Name 'Variable' -Value 123 -Option ReadOnly

上面的命令创建一个名为“Variable”、值为“123”的只读变量。一旦设置，变量的值就无法更改，除非使用 -Force 参数。

常量：带有常量选项的变量不能被修改或删除。要设置变量的选项，您可以使用 -Option 参数，后跟“所需的“常量”选项。例如：

Set-Variable -Name 'Variable' -Value 123 -Option Constant

上面的命令将“Variable”变量的选项设置为 Constant。

在 PowerShell 中清除变量

要清除 PowerShell 中变量的值，可以使用“Clear-Variable”cmdlet，后跟变量名称。您可以使用Remove-Variable清除变量或简单地将其设置为$null。例如：

Clear-Variable -Name myVariable

这将删除变量“myVariable”中存储的值。同样，您可以使用通配符清除多个变量，如下所示：

Clear-Variable -Name myVar*

要清除 PowerShell 中的所有变量，您只需关闭并重新打开 PowerShell 控制台或 PowerShell ISE 即可。您还可以将 $null 分配给变量值以清除其值。

在 PowerShell 中删除变量

除了清除变量之外，您还可以使用“Remove-Variable”cmdlet 在 PowerShell 中删除变量。此 cmdlet 会从内存中永久删除变量。例如：

Remove-Variable -Name age

这将从您的会话中删除变量“age”。

设置变量描述

为变量提供描述以记录其目的和用法是一个很好的做法。描述可以帮助其他脚本编写者理解变量的意图并正确使用它。

要为变量添加描述，可以使用Set-Variable 的-Description 参数。这是一个例子：

Set-Variable -Name 'Variable' -Value 123 -Description 'This variable has a description'

上面的命令将名为“Variable”的变量的值设置为“123”并为其添加描述。

要查看变量的描述，您可以使用 Get-Variable cmdlet。例如：

Get-Variable -Name 'Variable'

这将显示变量的名称、值和描述。

通过PowerShell设置环境变量

环境变量提供了一种动态配置 PowerShell 和其他程序设置的方法。要在 PowerShell 中设置环境变量，请在 Env: 驱动器中使用 Set-Item cmdlet，如下所示。例如，假设您有一个名为 Scripts 的文件夹，其中存储所有实用程序脚本，并且您希望将此文件夹添加到系统的 PATH 中，以便可以从任何地方运行这些脚本。

[Environment]::SetEnvironmentVariable("PATH", "$($env:PATH);C:\Scripts", [EnvironmentVariableTarget]::User)

更多信息请参见：如何使用 PowerShell 设置环境变量？

要避免的 PowerShell 变量陷阱

在 PowerShell 中使用变量时，还需要避免几个陷阱：

1. 覆盖变量：小心不要意外覆盖变量的值。这可能会导致脚本出现意外结果。
2. 过度使用全局变量：如前所述，全局变量会使代码更难维护和调试。谨慎使用它们。
3. 未初始化变量：未能初始化变量可能会导致脚本中出现错误。

在 PowerShell 中设置和管理变量的最佳实践

在 PowerShell 中使用变量时，需要记住以下几个最佳实践：

1. 使用描述性变量名称：选择有意义且具有描述性的变量名称。这使得在阅读脚本时更容易理解变量的用途。
2. 使用一致的命名约定：对变量使用一致的命名约定，使代码更易于阅读和维护。避免使用特殊字符并以字母开头。此外，PowerShell 不区分大小写，但为了可读性，坚持使用特定的大小写是一个很好的做法。
3. 初始化变量：始终使用默认值初始化变量，即使您计划稍后在脚本中更改它。
4. 使用正确的类型：为数据使用适当的变量类型，以确保脚本高效运行并避免错误。
5. 避免全局变量：全局变量会使代码更难调试和维护。只要有可能，就使用局部变量。
6. 为了有效地管理 PowerShell 中的变量，遵循一些最佳实践非常重要：
7. 不再需要时清除变量：不再需要时清除变量可以释放内存并防止潜在的混乱或错误。
8. 避免全局变量：全局变量可能会导致意外的副作用，并使代码更难调试。只要有可能，请将变量的范围限制为需要它们的特定函数或脚本。
9. 使用正确的变量作用域：PowerShell 支持不同的变量作用域，例如全局、脚本、本地和私有。了解并使用适当的变量范围有助于防止命名冲突并提高代码可读性。

概括

• PowerShell 中的变量可以存储和操作数据，使您的脚本更加灵活。
• 使用 Set-Variable cmdlet 创建或更改变量的值。
• 了解变量的范围：本地变量、全局变量或特定于脚本的变量。
• 根据需要分配默认值并将变量设置为只读或私有。
• 利用环境和自动变量来实现更动态的脚本编写。

本指南旨在成为掌握 PowerShell 中变量的综合资源。正确使用变量不仅会使您的脚本更加高效，而且更易于阅读和管理。

包起来

变量是 PowerShell 中的一个基本概念，允许您在脚本中存储和操作数据。在本综合指南中，我们探讨了在 PowerShell 中使用变量的基础知识。我们学习了如何在 PowerShell 中声明、设置、分配、列出、清除和删除变量。此外，我们还讨论了在 PowerShell 中设置变量的各个方面，包括基本赋值、使用 Set-Variable cmdlet、变量范围、只读变量、变量描述、选项和最佳实践。

请记住使用描述性变量名称、初始化变量并为数据选择适当的变量类型。通过掌握这些技术，您将能够利用 PowerShell 变量的强大功能来增强脚本编写和自动化任务。快乐的 PowerShell 脚本编写！