Set-Variable

Sintaxis

Default (Es el valor predeterminado).

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

Description

Ejemplos

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.

Parámetros

-Confirm

Prompts you for confirmation before running the cmdlet.

Propiedades del parámetro

Conjuntos de parámetros

-Description

Specifies the description of the variable.

Propiedades del parámetro

Conjuntos de parámetros

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

Propiedades del parámetro

Conjuntos de parámetros

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

Propiedades del parámetro

Conjuntos de parámetros

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

Propiedades del parámetro

Conjuntos de parámetros

-Name

Specifies the variable name.

Propiedades del parámetro

Conjuntos de parámetros

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

Propiedades del parámetro

Conjuntos de parámetros

-PassThru

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

Propiedades del parámetro

Conjuntos de parámetros

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

Propiedades del parámetro

Conjuntos de parámetros

-Value

Specifies the value of the variable.

Propiedades del parámetro

Conjuntos de parámetros

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

Propiedades del parámetro

Conjuntos de parámetros

-WhatIf

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

Propiedades del parámetro

Conjuntos de parámetros

CommonParameters

Entradas

Object

Salidas

None

PSVariable

Notas

Vínculos relacionados

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