Set-Variable

Синтаксис

Default (по умолчанию)

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

Описание

Примеры

Example 1: Set a variable and get its value

Set-Variable -Name "desc" -Value "A description"
Get-Variable -Name "desc"

Name                           Value
----                           -----
desc                           A description

Example 2: Set a global, read-only variable

Set-Variable -Name "processes" -Value (Get-Process) -Option Constant -Scope Global -Description "All processes" -PassThru |
    Format-List -Property *

Example 3: Understand public vs. private variables

New-Variable -Name "counter" -Visibility Public -Value 26
$Counter

26

Get-Variable c*

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

Set-Variable -Name "counter" -Visibility Private
Get-Variable c*

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

$counter

"Cannot access the variable '$counter' because it is a private variable"

.\use-counter.ps1
#Commands completed successfully.

Параметры

-Confirm

Prompts you for confirmation before running the cmdlet.

Свойства параметра

Наборы параметров

-Description

Specifies the description of the variable.

Свойства параметра

Наборы параметров

-Exclude

Specifies an array of items that this cmdlet excludes from the operation. The value of this parameter qualifies the Path parameter. Enter a path element or pattern, such as *.txt. Wildcards are permitted.

Свойства параметра

Наборы параметров

-Force

Allows you to create a variable with the same name as an existing read-only variable, or to change the value of a read-only variable.

By default, you can overwrite a variable, unless the variable has an option value of ReadOnly or Constant. For more information, see the Option parameter.

Свойства параметра

Наборы параметров

-Include

Specifies an array of items that this cmdlet includes in the operation. The value of this parameter qualifies the Name parameter. Enter a name or name pattern, such as c*. Wildcards are permitted.

Свойства параметра

Наборы параметров

-Name

Specifies the variable name.

Свойства параметра

Наборы параметров

-Option

Specifies the value of the Options property of the variable.

Valid values are:

• None: Sets no options. (None is the default.)
• ReadOnly: Can be deleted. Cannot be changed, except by using the Force parameter.
• Constant: Cannot be deleted or changed. Constant is valid only when you are creating a variable. You cannot change the options of an existing variable to Constant.
• Private: The variable is available only in the current scope.
• AllScope: The variable is copied to any new scopes that are created.

These values are defined as a flag-based enumeration. You can combine multiple values together to set multiple flags using this parameter. The values can be passed to the Option parameter as an array of values or as a comma-separated string of those values. The cmdlet will combine the values using a binary-OR operation. Passing values as an array is the simplest option and also allows you to use tab-completion on the values.

Свойства параметра

Наборы параметров

-PassThru

Returns an object representing the new variable. By default, this cmdlet does not generate any output.

Свойства параметра

Наборы параметров

-Scope

Specifies the scope of the variable.The acceptable values for this parameter are:

• Global
• Local
• Script
• Private
• A number relative to the current scope (0 through the number of scopes, where 0 is the current scope and 1 is its parent).

Local is the default.

For more information, see about_Scopes.

Свойства параметра

Наборы параметров

-Value

Specifies the value of the variable.

Свойства параметра

Наборы параметров

-Visibility

Determines whether the variable is visible outside of the session in which it was created. This parameter is designed for use in scripts and commands that will be delivered to other users.

Valid values are:

• Public: The variable is visible. (Public is the default.)
• Private: The variable is not visible.

When a variable is private, it does not appear in lists of variables, such as those returned by Get-Variable, or in displays of the Variable: drive. Commands to read or change the value of a private variable return an error. However, the user can run commands that use a private variable if the commands were written in the session in which the variable was defined.

Свойства параметра

Наборы параметров

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Свойства параметра

Наборы параметров

CommonParameters

Входные данные

Object

Выходные данные

None

PSVariable

Примечания

Связанные ссылки

• Clear-Variable
• Get-Variable
• New-Variable
• Remove-Variable