about_Remote_Variables

  • Cikk
  • 3 perc alatt elolvasható

Rövid leírás

Ismerteti, hogyan használhatók helyi és távoli változók távoli parancsokban.

Hosszú leírás

A távoli számítógépeken futtatott parancsokban változókat is használhat. Rendeljen hozzá egy értéket a változóhoz, majd használja a változót az érték helyett.

Alapértelmezés szerint a távoli parancsok változói a parancsot futtató munkamenetben lesznek definiálva. A helyi munkamenetben definiált változókat helyi változóként kell azonosítani a parancsban.

Távoli változók használata

A PowerShell feltételezi, hogy a távoli parancsokban használt változók abban a munkamenetben vannak definiálva, amelyben a parancs fut.

Ebben a példában a $ps változó abban az ideiglenes munkamenetben van definiálva, amelyben a Get-WinEvent parancs fut.

Invoke-Command -ComputerName S1 -ScriptBlock {
  $ps = "*PowerShell*"; Get-WinEvent -LogName $ps
}

Ha a parancs egy állandó munkamenetben , PSSession-ban fut, a távoli változót ebben a munkamenetben kell definiálni.

$s = New-PSSession -ComputerName S1
Invoke-Command -Session $s -ScriptBlock {$ps = "*PowerShell*"}
Invoke-Command -Session $s -ScriptBlock {Get-WinEvent -LogName $ps}

Helyi változók használata

A helyi változókat távoli parancsokban is használhatja, de a változót a helyi munkamenetben kell definiálni.

A PowerShell 3.0-tól kezdve a Using hatókör-módosítóval azonosíthat egy helyi változót egy távoli parancsban.

A szintaxisa Using a következő:

$Using:<VariableName>

Az alábbi példában a $ps változó a helyi munkamenetben jön létre, de abban a munkamenetben használatos, amelyben a parancs fut. A Using hatókör-módosító helyi változóként azonosít $ps .

$ps = "*PowerShell*"
Invoke-Command -ComputerName S1 -ScriptBlock {
  Get-WinEvent -LogName $Using:ps
}

A Using hatókör-módosító használható PSSession-ben.

$s = New-PSSession -ComputerName S1
$ps = "*PowerShell*"
Invoke-Command -Session $s -ScriptBlock {Get-WinEvent -LogName $Using:ps}

Egy változóhivatkozás, például $using:var kiterjeszti a változó $var értékét a hívó környezetéből. Nem fér hozzá a hívó változóobjektumához. A Using hatókör-módosító nem használható helyi változók módosítására a PSSessionban. A következő kód például nem működik:

$s = New-PSSession -ComputerName S1
$ps = "*PowerShell*"
Invoke-Command -Session $s -ScriptBlock {$Using:ps = 'Cannot assign new value'}

További információ a about_Scopes Using

Splatting használata

A PowerShell-splatting paraméternevek és -értékek gyűjteményét továbbítja egy parancsnak. További információ: about_Splatting.

Ebben a példában a splatting változó egy kivonattábla, $Splat amely a helyi számítógépen van beállítva. A Invoke-Command távoli számítógép-munkamenethez csatlakozik. A ScriptBlock a Using hatókör-módosítót az At (@) szimbólummal jelöli a kiszúrt változót.

$Splat = @{ Name = "Win*"; Include = "WinRM" }
Invoke-Command -Session $s -ScriptBlock { Get-Service @Using:Splat }

Egyéb helyzetek, amikor a "Használat" hatókör-módosítóra van szükség

A munkameneten kívül végrehajtott szkriptek vagy parancsok esetében a Using hatókör-módosítóra van szüksége a változóértékek beágyazásához a hívási munkamenet hatóköréből, hogy a munkameneten kívüli kód hozzáférhessen hozzájuk. A Using hatókör-módosító a következő környezetekben támogatott:

  • Távolról végrehajtott parancsok, a ComputerName, a HostName, az SSHConnection vagy a Session paraméterek (távoli munkamenet) használatával kezdve Invoke-Command
  • Háttérfeladatok, első lépések Start-Job (folyamaton kívüli munkamenet)
  • Szálfeladatok, vagy ForEach-Object -Parallel (Start-ThreadJobkülön hozzászóláslánc-munkamenettel) indítva

A környezettől függően a beágyazott változóértékek vagy a hívó hatókörében lévő adatok független másolatai, vagy arra mutató hivatkozások. A távoli és a folyamaton kívüli munkamenetekben ezek mindig független másolatok. A szál-munkamenetekben a rendszer hivatkozással továbbítja őket.

Változóértékek szerializálása

A távolról végrehajtott parancsok és háttérfeladatok folyamaton kívül futnak. A folyamaton kívüli munkamenetek XML-alapú szerializálással és deszerializálással teszik elérhetővé a változók értékeit a folyamathatárok között. A szerializálási folyamat az objektumokat PSObject típusúvá alakítja, amely az eredeti objektumtulajdonságokat tartalmazza, a metódusait azonban nem.

Korlátozott típusok esetén a deszerializálás újrahidratálja az objektumokat az eredeti típusra. A rehidratált objektum az eredeti objektumpéldány másolata. Típustulajdonságokkal és metódusokkal rendelkezik. Az egyszerű típusok, például a System.Version esetében a másolat pontos. Összetett típusok esetén a másolat nem tökéletes. A rehidratált tanúsítványobjektumok például nem tartalmazzák a titkos kulcsot.

Az összes többi típus példányai a PSObject-példányok . A PSTypeNames tulajdonság tartalmazza a Deserialized előtaggal előtaggal ellátott eredeti típusnevet, például : Deserialized.System.Data.DataTable

Helyi változók használata az ArgumentList paraméterrel

A távoli parancsok helyi változóit használhatja a távoli parancs paramétereinek definiálásával, valamint a parancsmag Argumentumlista paraméterével Invoke-Command a helyi változó paraméterértékként való megadásához.

  • param A kulcsszóval definiálhatja a távoli parancs paramétereit. A paraméternevek olyan helyőrzők, amelyeknek nem kell egyeznie a helyi változó nevével.

  • Használja a parancs kulcsszója által param definiált paramétereket.

  • A parancsmag ArgumentList paraméterével Invoke-Command paraméterértékként adja meg a helyi változót.

Az alábbi parancsok például meghatározzák a változót $ps a helyi munkamenetben, majd egy távoli parancsban használják. A parancs paraméternévként és helyi változóként használja $log az $psértékét.

$ps = "*PowerShell*"
Invoke-Command -ComputerName S1 -ScriptBlock {
  param($log)
  Get-WinEvent -LogName $log
} -ArgumentList $ps

Lásd még