New-PSSessionOption

  • Referencia
Modul:
Microsoft.PowerShell.Core

Létrehoz egy objektumot, amely speciális beállításokat tartalmaz a PSSessionhoz.

Syntax

New-PSSessionOption
   [-MaximumRedirection <Int32>]
   [-NoCompression]
   [-NoMachineProfile]
   [-Culture <CultureInfo>]
   [-UICulture <CultureInfo>]
   [-MaximumReceivedDataSizePerCommand <Int32>]
   [-MaximumReceivedObjectSize <Int32>]
   [-OutputBufferingMode <OutputBufferingMode>]
   [-MaxConnectionRetryCount <Int32>]
   [-ApplicationArguments <PSPrimitiveDictionary>]
   [-OpenTimeout <Int32>]
   [-CancelTimeout <Int32>]
   [-IdleTimeout <Int32>]
   [-ProxyAccessType <ProxyAccessType>]
   [-ProxyAuthentication <AuthenticationMechanism>]
   [-ProxyCredential <PSCredential>]
   [-SkipCACheck]
   [-SkipCNCheck]
   [-SkipRevocationCheck]
   [-OperationTimeout <Int32>]
   [-NoEncryption]
   [-UseUTF16]
   [-IncludePortInSPN]
   [<CommonParameters>]

Description

A New-PSSessionOption parancsmag létrehoz egy objektumot, amely speciális beállításokat tartalmaz egy felhasználó által felügyelt munkamenethez (PSSession). Az objektumot a PSSessiont létrehozó parancsmagok SessionOption paraméterének értékeként használhatja, például New-PSSession: , Enter-PSSessionés Invoke-Command.

Paraméterek nélkül létrehoz egy objektumot, New-PSSessionOption amely az összes beállítás alapértelmezett értékeit tartalmazza. Mivel minden tulajdonság szerkeszthető, az eredményként kapott objektumot sablonként használhatja, és szabványos beállításobjektumokat hozhat létre a vállalat számára.

A SessionOption objektumot a $PSSessionOption beállítási változóba is mentheti. A változó értékei új alapértelmezett értékeket hoznak létre a munkamenet-beállításokhoz. Akkor lépnek érvénybe, ha a munkamenethez nincs megadva munkamenet-beállítás, és elsőbbséget élveznek a munkamenet-konfigurációban megadott beállításokkal szemben, de felülbírálhatja őket a munkamenet beállításainak vagy egy munkamenetet létrehozó parancsmag SessionOption objektumának megadásával. A beállítási $PSSessionOption változóval kapcsolatos további információkért lásd: about_Preference_Variables.

Amikor munkamenetet létrehozó parancsmagban sessionOption objektumot használ, a munkamenet-beállításértékek elsőbbséget élveznek a $PSSessionOption beállításváltozóban és a munkamenet-konfigurációban beállított munkamenetek alapértelmezett értékeivel szemben. Azonban nem élveznek elsőbbséget a munkamenet-konfigurációban beállított maximális értékekkel, kvótával vagy korlátokkal szemben. A munkamenet-konfigurációkkal kapcsolatos további tudnivalókért tekintse meg az about_Session_Configuration_Files című témakört.

Példák

1. példa: Alapértelmezett munkamenet-beállítás létrehozása

Ez a parancs létrehoz egy SessionOption objektumot az alapértelmezett értékekkel.

New-PSSessionOption

MaximumConnectionRedirectionCount : 5
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : IEConfig
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : False
SkipCNCheck                       : False
SkipRevocationCheck               : False
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
Culture                           :
UICulture                         :
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         :
ApplicationArguments              :
OpenTimeout                       : 00:03:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : 00:04:00

2. példa: Munkamenet konfigurálása munkamenet-beállításobjektum használatával

Ez a példa bemutatja, hogyan konfigurálhat munkamenetet sessionOption objektummal.

$pso = New-PSSessionOption -Culture "fr-fr" -MaximumReceivedObjectSize 10MB
New-PSSession -ComputerName Server01 -SessionOption $pso

Az első parancs létrehoz egy új SessionOption objektumot, és menti azt a $pso változó értékében. A második parancs a New-PSSession parancsmaggal hoz létre munkamenetet a Server01 távoli számítógépen. A parancs a változó értékében $pso a SessionOption objektumot használja a parancs SessionOption paraméterének értékeként.

3. példa: Interaktív munkamenet indítása

Ez a parancs a Enter-PSSession parancsmaggal indít interaktív munkamenetet a Server01 számítógéppel.

Enter-PSSession -ComputerName Server01 -SessionOption (New-PSSessionOption -NoEncryption -NoCompression)

A SessionOption paraméter értéke egy New-PSSessionOption olyan parancs, amely NoEncryption és NoCompression paraméterekkel rendelkezik.

A New-PSSessionOption parancs zárójelek közé van zárva, így meggyőződhet arról, hogy a parancs a Enter-PSSession parancs előtt fut.

4. példa: Munkamenet-beállításobjektum módosítása

Ez a példa bemutatja, hogy módosíthatja a SessionOption objektumot. Minden tulajdonság rendelkezik olvasási/írási értékkel.

$a = New-PSSessionOption
$a.OpenTimeout

Days              : 0
Hours             : 0
Minutes           : 3
Seconds           : 0
Milliseconds      : 0
Ticks             : 1800000000
TotalDays         : 0.00208333333333333
TotalHours        : 0.05
TotalMinutes      : 3
TotalSeconds      : 180
TotalMilliseconds : 180000

$a.UICulture = (Get-UICulture)
$a.OpenTimeout = (New-Timespan -Minutes 4)
$a.MaximumConnectionRedirectionCount = 1
$a

MaximumConnectionRedirectionCount : 1
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : IEConfig
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : False
SkipCNCheck                       : False
SkipRevocationCheck               : False
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
Culture                           :
UICulture                         : en-US
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         :
ApplicationArguments              :
OpenTimeout                       : 00:04:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : 00:04:00

Ezzel a módszerrel létrehozhat egy standard munkamenet-objektumot a vállalat számára, majd létrehozhatja annak testreszabott verzióit bizonyos célokra.

5. példa: Beállítási változó létrehozása

Ez a parancs létrehoz egy beállításváltozót $PSSessionOption .

$PSSessionOption = New-PSSessionOption -OpenTimeOut 120000

Amikor a $PSSessionOption beállítási változó be van állítva a munkamenetben, a , Enter-PSSessionés Invoke-Command parancsmagokkal New-PSSessionlétrehozott munkamenetek beállításainak alapértelmezett értékeit hozza létre.

Ha a változót $PSSessionOption minden munkamenetben elérhetővé szeretné tenni, adja hozzá a PowerShell-munkamenethez és a PowerShell-profiljához.

A beállítási $PSSessionOption változóval kapcsolatos további információkért lásd: about_Preference_Variables. A profilokkal kapcsolatos további információkért lásd: about_Profiles.

6. példa: Távoli munkamenet-konfiguráció követelményeinek teljesítése

Ez a példa bemutatja, hogyan lehet sessionOption objektumot használni a távoli munkamenet-konfiguráció követelményeinek teljesítéséhez.

$skipCN = New-PSSessionOption -SkipCNCheck
New-PSSession -ComputerName 171.09.21.207 -UseSSL -Credential Domain01\User01 -SessionOption $SkipCN

Az első parancs a New-PSSessionOption parancsmaggal hoz létre egy SessionOption objektumot, amely rendelkezik a SkipCNCheck tulajdonsággal. A parancs menti az eredményként kapott munkamenet-objektumot a $skipCN változóban.

A második parancs a New-PSSession parancsmaggal hoz létre egy új munkamenetet egy távoli számítógépen. Az $skipCN ellenőrző változó a SessionOption paraméter értékében használatos.

Mivel a számítógépet az IP-címe azonosítja, a ComputerName paraméter értéke nem egyezik meg a Secure Sockets Layer (SSL) szolgáltatáshoz használt tanúsítvány egyik köznapi nevével sem. Ennek eredményeképpen a SkipCNCheck beállításra van szükség.

7. példa: Argumentumok elérhetővé tétele távoli munkamenet számára

Ez a példa bemutatja, hogyan használhatja a parancsmag ApplicationArguments paraméterét New-PSSessionOption további adatok elérhetővé tétele a távoli munkamenet számára.

$team = @{Team="IT"; Use="Testing"}
$TeamOption = New-PSSessionOption -ApplicationArguments $team
$s = New-PSSession -ComputerName Server01 -SessionOption $TeamOption
Invoke-Command -Session $s {$PSSenderInfo.ApplicationArguments}

Name                 Value
----                 -----
Team                 IT
Use                  Testing
PSVersionTable       {CLRVersion, BuildVersion, PSVersion, WSManStackVersion...}

Invoke-Command -Session $s {
  if ($PSSenderInfo.ApplicationArguments.Use -ne "Testing") {
    .\logFiles.ps1
  }
  else {
    "Just testing."
  }
}

Just testing.

Az első parancs létrehoz egy kivonattáblát, amely két kulcsból áll: Team (Csapat) és Use (Használat). A parancs menti a kivonattáblát a $team változóban. További információ a kivonattáblákról: about_Hash_Tables.

Ezután a New-PSSessionOption parancsmag az ApplicationArguments paraméterrel létrehoz egy SessionOption objektumot, amely a $team változóban van mentve. Amikor New-PSSessionOption létrehozza a munkamenet-beállításobjektumot, automatikusan átalakítja a kivonattáblát az ApplicationArguments paraméter értékéből egy PrimitiveDictionary értékre, így az adatok megbízhatóan továbbíthatók a távoli munkamenetbe.

A New-PSSession parancsmag elindít egy munkamenetet a Server01 számítógépen. A SessionOption paraméter használatával adja meg a változó beállításait $teamOption .

A Invoke-Command parancsmag azt mutatja be, hogy a változóban lévő $team adatok elérhetők a távoli munkamenet parancsai számára. Az adatok az automatikus változó ApplicationArguments tulajdonságában $PSSenderInfo jelennek meg.

Az utolsó Invoke-Command az adatok felhasználási módját mutatja be.

Paraméterek

-ApplicationArguments

A távoli munkamenetbe küldött PrimitiveDictionary paramétert adja meg. A távoli munkamenet parancsai és szkriptjei, beleértve a munkamenet konfigurációjában lévő indítási szkripteket, az automatikus változó ApplicationArguments tulajdonságában találják meg ezt a $PSSenderInfo szótárt. Ezzel a paraméterel adatokat küldhet a távoli munkamenetbe.

További információ: about_Hash_Tables, about_Session_Configurations és about_Automatic_Variables.

Type:PSPrimitiveDictionary
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CancelTimeout

Meghatározza, hogy mennyi ideig vár a PowerShell a megszakítási művelet (CTRL+C) befejezésére a befejezés előtt. Adjon meg egy értéket ezredmásodpercben.

Az alapértelmezett érték ( 60000 egy perc). A (nulla) érték 0 azt jelenti, hogy nincs időtúllépés; a parancs határozatlan ideig folytatódik.

Type:Int32
Aliases:CancelTimeoutMSec
Position:Named
Default value:60000
Accept pipeline input:False
Accept wildcard characters:False

-Culture

Megadja a munkamenethez használandó kulturális környezetet. Adjon meg egy kulturális nevet <languagecode2>-<country/regioncode2> formátumban (például ja-JP), egy CultureInfo objektumot tartalmazó változót vagy egy CultureInfo objektumot lekérő parancsot.

Az alapértelmezett érték a $Null, és az operációs rendszerben beállított kulturális környezet lesz használatban a munkamenetben.

Type:CultureInfo
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-IdleTimeout

Meghatározza, hogy mennyi ideig maradjon nyitva a munkamenet, ha a távoli számítógép nem kap kommunikációt a helyi számítógéptől. Ebbe beletartozik a szívverési jel is. Amikor az időköz lejár, a munkamenet bezárul.

A tétlen időtúllépési érték jelentős jelentőséggel bír, ha leválasztja a munkamenetet, és újra csatlakozik egy munkamenethez. Csak akkor csatlakozhat újra, ha a munkamenet nem időtúllépést észlelt.

Adjon meg egy értéket ezredmásodpercben. A minimális érték 60000 (1 perc). A maximális érték a munkamenet-konfiguráció MaxIdleTimeoutms tulajdonságának értéke. Az alapértelmezett érték () -1nem állít be üresjárati időtúllépést.

A munkamenet a munkamenet beállításaiban megadott üresjárati időtúllépést használja, ha van ilyen. Ha nincs beállítva (-1), a munkamenet a munkamenet-konfiguráció IdleTimeoutMs tulajdonságát vagy a WSMan rendszerhéj időtúllépési értékét (WSMan:\<ComputerName>\Shell\IdleTimeout) használja, amelyik a legrövidebb.

Ha a munkamenet-beállításokban megadott tétlen időtúllépés meghaladja a munkamenet-konfiguráció MaxIdleTimeoutMs tulajdonságának értékét, a munkamenet létrehozására vonatkozó parancs meghiúsul.

Az alapértelmezett Microsoft IdleTimeoutMs értéke. A PowerShell-munkamenet konfigurációja 7200000 ezredmásodperc (2 óra). A MaxIdleTimeoutMs értéke 2147483647 ezredmásodperc (>24 nap). A WSMan rendszerhéj tétlen időtúllépésének (WSMan:\<ComputerName>\Shell\IdleTimeout) 7200000 alapértelmezett értéke ezredmásodperc (2 óra).

A munkamenet tétlen időtúllépési értéke is módosítható, ha leválaszt egy munkamenetről, vagy újra csatlakozik egy munkamenethez. További információ: Disconnect-PSSession és Connect-PSSession.

A Windows PowerShell 2.0-s verziójában az IdleTimeout paraméter 240000 alapértelmezett értéke (4 perc).

Type:Int32
Aliases:IdleTimeoutMSec
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-IncludePortInSPN

Tartalmazza a Kerberos-hitelesítéshez használt egyszerű szolgáltatásnév (SPN) portszámát, például HTTP://<ComputerName>:5985: . Ez a beállítás lehetővé teszi, hogy a nem alapértelmezett egyszerű szolgáltatásnévvel rendelkező ügyfelek kerberos hitelesítést használó távoli számítógépen végezzenek hitelesítést.

Ez a lehetőség olyan vállalatok számára lett kialakítva, ahol a Kerberos-hitelesítést támogató szolgáltatások különböző felhasználói fiókokban futnak. Például egy Kerberos-hitelesítést lehetővé tevő IIS-alkalmazás megkövetelheti, hogy az alapértelmezett egyszerű szolgáltatásnév regisztrálva legyen a számítógépfióktól eltérő felhasználói fiókban. Ilyen esetekben a PowerShell-távelérés nem tudja használni a Kerberost a hitelesítéshez, mert a számítógépfiókban regisztrált egyszerű szolgáltatásnévre van szükség. A probléma megoldásához a rendszergazdák különböző egyszerű szolgáltatásneveket hozhatnak létre, például a használatával Setspn.exe, amelyek különböző felhasználói fiókokban vannak regisztrálva, és különbséget tehetnek közöttük a portszámnak az egyszerű szolgáltatásnévbe való beiktatásával.

További információ: Setspn – áttekintés.

Ez a paraméter a Windows PowerShell 3.0-s verzióban lett bevezetve.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MaxConnectionRetryCount

Megadja, hogy a PowerShell hányszor kísérel meg kapcsolatot létesíteni egy célgéppel, ha az aktuális kísérlet hálózati problémák miatt meghiúsul. Az alapértelmezett érték 5.

Ez a paraméter a PowerShell 5.0-s verziójához lett hozzáadva.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MaximumReceivedDataSizePerCommand

Meghatározza, hogy a helyi számítógép hány bájtot fogadhat egyetlen parancsban a távoli számítógépről. Adjon meg egy értéket bájtban. Alapértelmezés szerint nincs adatméretkorlát.

Ez a beállítás az ügyfélszámítógép erőforrásainak védelmére lett kialakítva.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MaximumReceivedObjectSize

Megadja egy objektum maximális méretét, amelyet a helyi számítógép fogadhat a távoli számítógépről. Ez a beállítás az ügyfélszámítógép erőforrásainak védelmére lett kialakítva. Adjon meg egy értéket bájtban.

A Windows PowerShell 2.0-ban, ha kihagyja ezt a paramétert, nincs objektumméretkorlát. A Windows PowerShell 3.0-tól kezdődően, ha kihagyja ezt a paramétert, az alapértelmezett érték 209715200 bájt (vagy 200MB).

Type:Int32
Position:Named
Default value:209715200
Accept pipeline input:False
Accept wildcard characters:False

-MaximumRedirection

Meghatározza, hogy a PowerShell hányszor irányítja át a kapcsolatot egy alternatív egységes erőforrás-azonosítóhoz (URI) a kapcsolat meghiúsulása előtt. Az alapértelmezett érték 5. A (nulla) érték 0 megakadályozza az összes átirányítást.

Ez a beállítás csak akkor használatos a munkamenetben, ha a munkamenetet létrehozó parancs az AllowRedirection paramétert használja.

Type:Int32
Position:Named
Default value:5
Accept pipeline input:False
Accept wildcard characters:False

-NoCompression

A csomagtömörítés kikapcsolása a munkamenetben. A tömörítés több processzorciklust használ, de felgyorsítja az átvitelt.

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-NoEncryption

Kikapcsolja az adattitkosítást.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-NoMachineProfile

Megakadályozza a felhasználó Windows-felhasználói profiljának betöltését. Emiatt előfordulhat, hogy a munkamenet gyorsabban létrejön, de a felhasználóspecifikus beállításjegyzék-beállítások, az elemek, például a környezeti változók és a tanúsítványok nem érhetők el a munkamenetben.

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-OpenTimeout

Meghatározza, hogy az ügyfélszámítógép mennyi ideig várja a munkamenet-kapcsolat létrejöttét. Ha az időköz lejár, a kapcsolat létrehozásához szükséges parancs meghiúsul. Adjon meg egy értéket ezredmásodpercben.

Az alapértelmezett érték 180000 (3 perc). A (nulla) érték 0 azt jelenti, hogy nincs időtúllépés; a parancs határozatlan ideig folytatódik.

Type:Int32
Aliases:OpenTimeoutMSec
Position:Named
Default value:180000 (3 minutes)
Accept pipeline input:False
Accept wildcard characters:False

-OperationTimeout

Meghatározza, hogy a WinRM legfeljebb mennyi időt vár az élő kapcsolat pozitív kapcsolattesztjeire a kapcsolat időtúllépésének kezdeményezése előtt. A WinRM-ről további információt a Windows távfelügyeleti dokumentációjában talál.

Az OperationTimeoutnem ír elő időkorlátot a távoli munkamenetben futó parancsokra vagy folyamatokra, és nem befolyásolja az egyéb újraegyezési protokollokat, például az SSH-t.

Az alapértelmezett érték 180000 (3 perc). A (nulla) érték 0 azt jelenti, hogy nincs időtúllépés.

Type:Int32
Aliases:OperationTimeoutMSec
Position:Named
Default value:180000 (3 minutes)
Accept pipeline input:False
Accept wildcard characters:False

-OutputBufferingMode

Meghatározza, hogyan történik a parancskimenet kezelése a leválasztott munkamenetekben, amikor a kimeneti puffer megtelik.

Ha a kimeneti pufferelési mód nincs beállítva a munkamenetben vagy a munkamenet konfigurációjában, az alapértelmezett érték a .Block A felhasználók a munkamenet leválasztásakor is módosíthatják a kimeneti pufferelési módot.

Ha kihagyja ezt a paramétert, a SessionOption objektum OutputBufferingMode értéke .None A kimeneti pufferelési mód átviteli beállításának Block értéke vagy Drop felülbírálása a munkamenet-konfigurációban. A paraméter elfogadható értékei a következők:

  • Block. Ha a kimeneti puffer megtelt, a végrehajtás fel van függesztve, amíg a puffer nem törlődik.
  • Drop. Ha a kimeneti puffer megtelt, a végrehajtás folytatódik. Az új kimenet mentésekor a rendszer elveti a legrégebbi kimenetet.
  • None. Nincs megadva kimeneti pufferelési mód.

További információ a kimeneti pufferelési mód átviteli lehetőségéről: New-PSTransportOption.

Ez a paraméter a Windows PowerShell 3.0-s verzióban lett bevezetve.

Type:OutputBufferingMode
Accepted values:None, Drop, Block
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ProxyAccessType

Meghatározza, hogy melyik mechanizmust használja a gazdagépnév feloldásához. A paraméter elfogadható értékei a következők:

  • IEConfig
  • WinHttpConfig
  • AutoDetect
  • NoProxyServer
  • None

Az alapértelmezett érték None.

A paraméter értékeivel kapcsolatos információkért lásd: ProxyAccessType Enumerálás.

Type:ProxyAccessType
Accepted values:None, IEConfig, WinHttpConfig, AutoDetect, NoProxyServer
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ProxyAuthentication

Megadja a proxyfeloldáshoz használt hitelesítési módszert. A paraméter elfogadható értékei a következők:

  • Basic
  • Digest
  • Negotiate

Az alapértelmezett érték Negotiate.

A paraméter értékeivel kapcsolatos további információkért lásd: AuthenticationMechanism Enumeráció.

Type:AuthenticationMechanism
Accepted values:Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:Named
Default value:Negotiate
Accept pipeline input:False
Accept wildcard characters:False

-ProxyCredential

Megadja a proxyhitelesítéshez használandó hitelesítő adatokat. Adjon meg egy PSCredential objektumot tartalmazó változót vagy egy PSCredential objektumot lekérő parancsot, például egy parancsot Get-Credential . Ha ez a beállítás nincs beállítva, nincs megadva hitelesítő adat.

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SkipCACheck

Megadja, hogy ha HTTPS-en keresztül csatlakozik, az ügyfél nem ellenőrzi, hogy a kiszolgálótanúsítványt megbízható hitelesítésszolgáltató (CA) írta-e alá.

Ezt a beállítást csak akkor használja, ha a távoli számítógép megbízható egy másik mechanizmussal, például ha a távoli számítógép fizikailag biztonságos és elkülönített hálózat része, vagy ha a távoli számítógép megbízható gazdagépként szerepel egy WinRM-konfigurációban.

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipCNCheck

Azt adja meg, hogy a kiszolgáló tanúsítványának köznapi neve (CN) ne egyezzen meg a kiszolgáló állomásnevével. Ez a beállítás csak a HTTPS protokollt használó távoli műveletekben használható.

Ezt a beállítást csak megbízható számítógépekhez használja.

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipRevocationCheck

Nem ellenőrzi a kiszolgálótanúsítvány visszavonási állapotát.

Type:SwitchParameter
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-UICulture

Megadja a munkamenethez használni kívánt felhasználói felületi kultúrát.

Az érvényes értékek a következők:

  • Kulturális név <languagecode2>-<country/regioncode2> formátumban, például ja-JP
  • CultureInfo objektumot tartalmazó változó
  • Egy CultureInfo objektumot lekérő parancs, például Get-Culture

Az alapértelmezett érték a $null, és az operációs rendszerben a munkamenet létrehozásakor beállított felhasználói felületi kultúra.

Type:CultureInfo
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UseUTF16

Azt jelzi, hogy ez a parancsmag UTF16 formátumban kódolja a kérést UTF8 formátum helyett.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat átirányítani.

Kimenetek

PSSessionOption

Jegyzetek

Ha a SessionOption paramétert nem használja egy parancs a PSSession létrehozásához, a munkamenet-beállításokat a $PSSessionOption beállítási változó tulajdonságértékei határozzák meg, ha be van állítva. A változóval kapcsolatos $PSSessionOption további információkért lásd: about_Preference_Variables.

A munkamenet-konfigurációs objektumok tulajdonságai a munkamenet-konfiguráció beállításaitól és a beállítások értékeitől függően változnak. Emellett a munkamenet-konfigurációs fájlt használó munkamenet-konfigurációk további tulajdonságokkal rendelkeznek.