Set-Variable

Sintassi

Default (impostazione predefinita).

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

Descrizione

Esempio

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.

Parametri

-Confirm

Prompts you for confirmation before running the cmdlet.

Proprietà dei parametri

Set di parametri

-Description

Specifies the description of the variable.

Proprietà dei parametri

Set di parametri

-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.

Proprietà dei parametri

Set di parametri

-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.

Proprietà dei parametri

Set di parametri

-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.

Proprietà dei parametri

Set di parametri

-Name

Specifies the variable name.

Proprietà dei parametri

Set di parametri

-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.

Proprietà dei parametri

Set di parametri

-PassThru

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

Proprietà dei parametri

Set di parametri

-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.

Proprietà dei parametri

Set di parametri

-Value

Specifies the value of the variable.

Proprietà dei parametri

Set di parametri

-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.

Proprietà dei parametri

Set di parametri

-WhatIf

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

Proprietà dei parametri

Set di parametri

CommonParameters

Input

Object

Output

None

PSVariable

Note

Collegamenti correlati

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