Set-Variable

Syntax

Default (Standard)

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

Description

Exempel

Exempel 1: Ange en variabel och hämta dess värde

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

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

Exempel 2: Ange en global, skrivskyddad variabel

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

Exempel 3: Förstå offentliga och privata variabler

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.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Parameteregenskaper

Parameteruppsättningar

-Description

Anger beskrivningen av variabeln.

Parameteregenskaper

Parameteruppsättningar

-Exclude

Anger en matris med objekt som den här cmdleten undantar från åtgärden. Värdet för den här parametern kvalificerar parametern Path. Ange ett sökvägselement eller mönster, till exempel *.txt. Jokertecken tillåts.

Parameteregenskaper

Parameteruppsättningar

-Force

Gör att du kan skapa en variabel med samma namn som en befintlig skrivskyddad variabel eller ändra värdet för en skrivskyddad variabel.

Som standard kan du skriva över en variabel, såvida inte variabeln har ett alternativvärde på ReadOnly eller Constant. Mer information finns i parametern Alternativ.

Parameteregenskaper

Parameteruppsättningar

-Include

Anger en matris med objekt som den här cmdleten innehåller i åtgärden. Värdet för den här parametern kvalificerar parametern Name. Ange ett namn- eller namnmönster, till exempel c*. Jokertecken tillåts.

Parameteregenskaper

Parameteruppsättningar

-Name

Anger variabelnamnet.

Parameteregenskaper

Parameteruppsättningar

-Option

Anger värdet för egenskapen Alternativ för variabeln.

Giltiga värden är:

• None: Anger inga alternativ. (None är standard.)
• ReadOnly: Kan tas bort. Det går inte att ändra, förutom med hjälp av force-parametern.
• Constant: Det går inte att ta bort eller ändra. Constant är endast giltigt när du skapar en variabel. Du kan inte ändra alternativen för en befintlig variabel till Constant.
• Private: Variabeln är endast tillgänglig i det aktuella omfånget.
• AllScope: Variabeln kopieras till alla nya omfång som skapas.

Dessa värden definieras som en flaggbaserad uppräkning. Du kan kombinera flera värden för att ange flera flaggor med hjälp av den här parametern. Värdena kan skickas till parametern Alternativ som en matris med värden eller som en kommaavgränsad sträng av dessa värden. Cmdleten kombinerar värdena med hjälp av en binär-OR-åtgärd. Att skicka värden som en matris är det enklaste alternativet och du kan även använda tab-completion på värdena.

Parameteregenskaper

Parameteruppsättningar

-PassThru

Returnerar ett objekt som representerar den nya variabeln. Som standard genererar den här cmdleten inga utdata.

Parameteregenskaper

Parameteruppsättningar

-Scope

Anger variabelns omfång. De godtagbara värdena för den här parametern är:

• Global
• Local
• Script
• Private
• Ett tal i förhållande till det aktuella omfånget (0 genom antalet omfång, där 0 är det aktuella omfånget och 1 är dess överordnade).

Local används som standard.

Mer information finns i about_Scopes.

Parameteregenskaper

Parameteruppsättningar

-Value

Anger värdet för variabeln.

Parameteregenskaper

Parameteruppsättningar

-Visibility

Avgör om variabeln visas utanför sessionen där den skapades. Den här parametern är utformad för användning i skript och kommandon som ska levereras till andra användare.

Giltiga värden är:

• Public: Variabeln är synlig. (Public är standard.)
• Private: Variabeln visas inte.

När en variabel är privat visas den inte i listor med variabler, till exempel de som returneras av Get-Variableeller i visning av Variabel: enhet. Kommandon för att läsa eller ändra värdet för en privat variabel returnerar ett fel. Användaren kan dock köra kommandon som använder en privat variabel om kommandona skrevs i sessionen där variabeln definierades.

Parameteregenskaper

Parameteruppsättningar

-WhatIf

Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.

Parameteregenskaper

Parameteruppsättningar

CommonParameters

Indata

Object

Utdata

None

PSVariable

Kommentarer

Relaterade länkar

• Clear-Variable
• Get-Variable
• Ny-Variabel
• Ta bort variabel