Set-Variable

Set-Variable
    [-Name] <String[]>
    [[-Value] <Object>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Description <String>]
    [-Option <ScopedItemOptions>]
    [-Force]
    [-Visibility <SessionStateEntryVisibility>]
    [-PassThru]
    [-Scope <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Set-Variable cmdlet 将值分配给指定的变量或更改当前值。 如果该变量不存在，则 cmdlet 会创建它。

PS C:\> Set-Variable -Name "desc" -Value "A description"
PS C:\> Get-Variable -Name "desc"

这些命令将 desc 变量的值设置为 A 说明，然后获取变量的值。

PS C:\> Set-Variable -Name "processes" -Value (Get-Process) -Option constant -Scope global -Description "All processes" -PassThru | Format-List -Property *

此命令创建一个全局只读变量，其中包含系统上的所有进程，然后显示该变量的所有属性。

该命令使用 Set-Variable cmdlet 来创建变量。 它使用 PassThru 参数创建表示新变量的对象，并使用管道运算符 （|） 将对象传递给 Format-List cmdlet。 它使用 属性 参数 Format-List 的值为 all = 以显示新创建的变量的所有属性。

值“（Get-Process）”括在括号中，以确保在变量中存储之前执行该值。 否则，该变量包含单词“Get-Process”。

PS C:\> New-Variable -Name "counter" -Visibility Public -Value 26
PS C:\> $Counter
26
PS C:\> Get-Variable c*

Name                  Value
----                  -----
Culture               en-US
ConsoleFileName
ConfirmPreference     High
CommandLineParameters {}
Counter               26

PS C:\> Set-Variable -Name "counter" -Visibility Private
PS C:\> Get-Variable c*

Name                  Value
----                  -----
Culture               en-US
ConsoleFileName
ConfirmPreference     High
CommandLineParameters {}

 PS C:\> $counter
"Cannot access the variable '$counter' because it is a private variable"

PS C:\> .\use-counter.ps1
#Commands completed successfully.

此命令演示如何将变量的可见性更改为 Private。 此变量可由具有所需权限的脚本读取和更改，但对用户不可见。

示例输出显示了公共变量和私有变量行为的差异。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

可以通过管道传递一个对象，该对象表示变量的值以 Set-Variable。

使用 PassThru 参数时，Set-Variable 生成表示新变量或更改的 System.Management.Automation.PSVariable 对象。 否则，此 cmdlet 不会生成任何输出。