Megosztás a következőn keresztül:

New-Variable

Modul:
Microsoft.PowerShell.Utility Module

Létrehoz egy új változót.

Syntax

Default (Alapértelmezett) 

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

Description

A Új változó parancsmag létrehoz egy új változót a Windows PowerShellben. A változó létrehozásakor, illetve az érték hozzárendelése vagy módosítása után is hozzárendelhet egy értéket a változóhoz.

A New-Variable paramétereivel beállíthatja a változó tulajdonságait, beállíthatja egy változó hatókörét, és meghatározhatja, hogy a változók nyilvánosak vagy privátak-e.

Általában új változót hoz létre a változó nevének és értékének (például $Var = 3) beírásával, de a paraméterek használatához használhatja a New-Variable parancsmagot.

Példák

1. példa: Változó létrehozása

PS C:\> New-Variable days

Ez a parancs létrehoz egy nap nevű új változót. Nem kell beírnia a Név paramétert.

2. példa: Változó létrehozása és érték hozzárendelése

PS C:\> New-Variable -Name "zipcode" -Value 98033

Ez a parancs létrehoz egy irányítószám nevű változót, és hozzárendeli a 98033-at.

3. példa: Változó létrehozása a ReadOnly beállítással

PS C:\> New-Variable -Name Max -Value 256 -Option ReadOnly
PS C:\> New-Variable -Name max -Value 1024

New-Variable : A variable with name 'max' already exists.
At line:1 char:1
+ New-Variable -Name max -Value 1024
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : ResourceExists: (max:String) [New-Variable], SessionStateException
    + FullyQualifiedErrorId : VariableAlreadyExists,Microsoft.PowerShell.Commands.NewVariableCommand

PS C:\> New-Variable -Name max -Value 1024 -Force

Ez a példa bemutatja, hogyan védheti meg a változók felülírását az új változók ReadOnly lehetőségével.

Az első parancs létrehoz egy Max nevű új változót, és 256-ra állítja az értékét. A Option paramétert használja ReadOnly értékkel.

A második parancs egy második változót próbál létrehozni ugyanazzal a névvel. Ez a parancs hibát ad vissza, mert az írásvédett beállítás be van állítva a változón.

A harmadik parancs a Force paramétert használja a változó írásvédett védelmének felülbírálásához. Ebben az esetben az azonos nevű új változó létrehozásához használt parancs sikeres.

4. példa: Privát változó létrehozása

PS C:\> New-Variable -Name counter -Visibility Private

#Effect of private variable in a module.

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"
At line:1 char:1
+ $counter
+ ~~~~~~~~
    + CategoryInfo          : PermissionDenied: (counter:String) [], SessionStateException
    + FullyQualifiedErrorId : VariableIsPrivate

PS C:\> Get-Counter
Name         Value
----         -----
Counter1     3.1415
...

Ez a parancs bemutatja egy privát változó viselkedését egy modulban. A modul tartalmazza a Get-Counter parancsmagot, amely számláló nevű privát változóval rendelkezik. A parancs a Láthatóság paramétert használja privát értékkel a változó létrehozásához.

A mintakimenet egy privát változó viselkedését mutatja. A modult betöltött felhasználó nem tekintheti meg vagy módosíthatja a Számláló változó értékét, de a Számláló változót a modul parancsai olvashatják és módosíthatják.

5. példa: Változó létrehozása szóközzel

PS C:\> New-Variable -Name 'with space' -Value 'abc123xyz'

PS C:\> Get-Variable -Name 'with space'

Name                           Value
----                           -----
with space                     abc123xyz

PS C:\> ${with space}
abc123xyz

Ez a parancs bemutatja, hogy szóközökkel rendelkező változók hozhatók létre. A változók a Get-Variable parancsmaggal érhetők el, vagy közvetlenül egy változó kapcsos elválasztásával.

Paraméterek

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Cf

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Description

A változó leírását adja meg.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Force

Azt jelzi, hogy a parancsmag egy olyan változót hoz létre, amelynek neve megegyezik egy meglévő írásvédett változó nevével.

Alapértelmezés szerint felülírhat egy változót, kivéve, ha a változó beállítási értéke ReadOnly vagy Constant. További információ: Option paraméter.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Name

Megadja az új változó nevét.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:0
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-Option

A változó Beállítások tulajdonságának értékét adja meg. A paraméter elfogadható értékei a következők:

  • Nincs. Nem ad meg beállításokat. (Nincs az alapértelmezett érték.)
  • Írásvédett. Törölhető. Nem módosítható, kivéve a Force paramétert.
  • Privát. A változó csak az aktuális hatókörben érhető el.
  • Mindenhatókör. A változó a létrehozott új hatókörökbe lesz másolva.
  • Konstans. Nem törölhető vagy módosítható. Az állandó csak változó létrehozásakor érvényes. A meglévő változók beállításait nem módosíthatja állandóra.

A munkamenet összes változójának Beállítások tulajdonságának megtekintéséhez írja be a Get-Variable | Format-Table -Property name, options -autosize.

Paramétertulajdonságok

Típus:ScopedItemOptions
Alapértelmezett érték:None
Elfogadott értékek:None, ReadOnly, Constant, Private, AllScope, Unspecified
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-PassThru

Azt az elemet képviselő objektumot adja vissza, amellyel dolgozik. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Scope

Az új változó hatókörét adja meg. A paraméter elfogadható értékei a következők:

  • Globális. A globális hatókörben létrehozott változók mindenhol elérhetők egy PowerShell-folyamat során.
  • Helyi. A helyi hatókör az aktuális hatókörre hivatkozik, ez a környezettől függően bármilyen hatókör lehet.
  • Forgatókönyv. A szkript hatókörében létrehozott változók csak abban a szkriptfájlban vagy modulban érhetők el, amelyben létrehozták őket.
  • Privát. A privát hatókörben létrehozott változók nem érhetők el azon a hatókörön kívül, amelyben léteznek. A privát hatókör használatával létrehozhat egy azonos nevű elem privát verzióját egy másik hatókörben.
  • Az aktuális hatókörhöz viszonyított szám (0 a hatókörök számán keresztül, ahol a 0 az aktuális hatókör, 1 a szülő, 2 a szülő hatókör szülője stb.). Negatív számok nem használhatók.

A helyi az alapértelmezett hatókör, ha a hatókörparaméter nincs megadva.

További információ: about_Scopes.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Value

A változó kezdeti értékét adja meg.

Paramétertulajdonságok

Típus:Object
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:1
Kötelező:False
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-Visibility

Meghatározza, hogy a változó látható-e azon a munkameneten kívül, amelyben létrejött. Ez a paraméter olyan szkriptekben és parancsokban való használatra lett kialakítva, amelyek más felhasználók számára lesznek kézbesítve. A paraméter elfogadható értékei a következők:

  • Nyilvános. A változó látható. (A nyilvános az alapértelmezett érték.)
  • Privát. A változó nem látható.

Ha egy változó privát, nem jelenik meg a változók listájában, például a Get-Variable által visszaadott listákban vagy a Változó: meghajtó kijelzőiben. A privát változók értékének olvasására vagy módosítására szolgáló parancsok hibát adnak vissza. A felhasználó azonban futtathat privát változót használó parancsokat, ha a parancsok abban a munkamenetben lettek megírva, amelyben a változót definiálták.

Paramétertulajdonságok

Típus:SessionStateEntryVisibility
Alapértelmezett érték:None
Elfogadott értékek:Public, Private
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Wi

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

Object

Az értékeket a New-Variableadhatja meg.

Kimenetek

None or System.Management.Automation.PSVariable

Ha a PassThru paramétert használja, Új változó létrehoz egy System.Management.Automation.PSVariable objektumot, amely az új változót jelöli. Ellenkező esetben ez a parancsmag nem hoz létre kimenetet.