New-PSSessionOption

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 használhatja a PSSessiont létrehozó parancsmagok SessionOption paraméterének értékeként, 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.

SessionOption objektumot is menthet a $PSSessionOption beállításváltozóban. 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ások vagy egy munkamenetet létrehozó parancsmag MunkamenetOption-objektumának megadásával. A beállítási változóval kapcsolatos további információkért $PSSessionOption 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 elsőbbséget élveznek 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 a változó értékében $pso . 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 egy 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 noEncryption és NoCompression paraméterekkel rendelkező parancs.

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 olvasási/írási értékkel rendelkezik.

$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 szabványos munkamenet-objektumot a vállalat számára, majd létrehozhatja annak testreszabott verzióit bizonyos célokra.

5. példa: Beállításvá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, az alapértelmezett értékeket állítja be a munkamenetekben a , Enter-PSSessionés Invoke-Command parancsmagokkal New-PSSessionlétrehozott beállításokhoz.

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

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

6. példa: A 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 a Secure Sockets Layer (SSL) szolgáltatáshoz használt tanúsítvány egyik gyakori nevével sem. Ennek eredményeképpen a SkipCNCheck beállítás szükséges.

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

Ez a példa bemutatja, hogyan használható a parancsmag ApplicationArguments paramétere további New-PSSessionOption 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 két kulccsal, a Csapat és a Használat paranccsal. 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. A munkamenet-beállításobjektum létrehozásakor New-PSSessionOption automatikusan átalakítja az ApplicationArguments paraméter értékében lévő kivonattáblát 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 $teamOption változó beállításait.

A Invoke-Command parancsmag bemutatja, hogy a $team változóban lévő 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
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Culture

Megadja a munkamenethez használni kívánt kultúrát. Adjon meg egy kulturális nevet <languagecode2>-<country/regioncode2> formátumban (példáulja-JP), egy CultureInfo objektumot tartalmazó változót, vagy egy CultureInfo objektumot lekérő parancsot.

Az alapértelmezett érték az $Null, és az operációs rendszerben beállított kultúra lesz használatban a munkamenetben.

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

-IdleTimeout

Meghatározza, hogy a munkamenet mennyi ideig maradjon nyitva, ha a távoli számítógép nem kap kommunikációt a helyi számítógépről. Ez magában foglalja a szívverés jelét. Ha 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álasztani és újra szeretne kapcsolódni egy munkamenethez. Csak akkor csatlakozhat újra, ha a munkamenet nem időtúllépést ért el.

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 nem -1állít be tétlen időtúllépést.

A munkamenet a munkamenet beállításaiban megadott tétlenségi 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ának vagy a WSMan rendszerhéj időtúllépési értékének (WSMan:\<ComputerName>\Shell\IdleTimeouta legrövidebb) értékét használja.

Ha a munkamenet beállításaiban beállított tétlenség túllépi a munkamenet-konfiguráció MaxIdleTimeoutMs tulajdonságának értékét, a munkamenet létrehozásához szükséges parancs meghiúsul.

Az alapértelmezett Microsoft.PowerShell-munkamenet-konfiguráció7200000 IdleTimeoutMs értéke ezredmásodperc (2 óra). A MaxIdleTimeoutMs értéke 2147483647 ezredmásodperc (>24 nap). A WSMan rendszerhéj alapjárati 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 akkor is módosítható, ha leválasztja a munkamenetet, vagy újracsatlakozik egy munkamenethez. További információ: Disconnect-PSSession és Connect-PSSession.

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

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

-IncludePortInSPN

Tartalmazza például a Kerberos-hitelesítéshez HTTP://<ComputerName>:5985használt egyszerű szolgáltatásnév (SPN) portszámát. 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 hitelesítsék magukat.

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-remoting nem használhatja 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ő spN-eket hozhatnak létre, például a Setspn.exekülönböző felhasználói fiókokban regisztrált, és a portszámnak az egyszerű szolgáltatásnévbe való beiktatásával különbséget tehetnek közöttük.

További információt a Setspn áttekintésében talál.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaximumReceivedDataSizePerCommand

Megadja, 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 szolgál.

Type:Int32
Position:Named
Default value:None
Required:False
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 szolgál. 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
Required:False
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), mielőtt a kapcsolat meghiúsul. 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
Required:False
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 gyorsabbá teszi az átvitelt.

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

-NoEncryption

Kikapcsolja az adattitkosítást.

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

-NoMachineProfile

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

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

-OpenTimeout

Meghatározza, hogy az ügyfélszámítógép mennyi ideig várja meg a munkamenet-kapcsolat létrehozásá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)
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OperationTimeout

Meghatározza, hogy a WinRM maximálisan 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 OperationTimeout nemír elő időkorlátot a távoli munkamenetben futó parancsokra vagy folyamatokra, és nem befolyásolja az egyéb újraküldé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)
Required:False
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óban, az alapértelmezett érték a .Block A felhasználók a munkamenet leválasztásakor a kimeneti pufferelési módot is módosíthatják.

Ha kihagyja ezt a paramétert, a SessionOption objektum OutputBufferingMode értéke .None A munkamenet-konfigurációban beállított kimeneti pufferelési mód átviteli beállításának Block értéke vagy Drop felülbírálása. 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 tiszta.
  • 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.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Type:OutputBufferingMode
Accepted values:None, Drop, Block
Position:Named
Default value:None
Required:False
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ékeiről további információt a ProxyAccessType Enumerálás című témakörben talál.

Type:ProxyAccessType
Accepted values:None, IEConfig, WinHttpConfig, AutoDetect, NoProxyServer
Position:Named
Default value:None
Required:False
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 Enumeration.

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

-ProxyCredential

Megadja a proxyhitelesítéshez használandó hitelesítő adatokat. Adjon meg egy olyan változót, amely PSCredential objektumot vagy PSCredential objektumot lekérő parancsot (például parancsotGet-Credential) tartalmaz. Ha ez a beállítás nincs beállítva, a rendszer nem ad meg hitelesítő adatokat.

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

-SkipCACheck

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

Ezt a lehetőséget 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 izolált hálózat része, vagy ha a távoli számítógép megbízható gazdagépként szerepel a WinRM-konfigurációban.

Type:SwitchParameter
Position:Named
Default value:False
Required: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) nem egyezik meg a kiszolgáló gazdagépnevé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épekre használhatja.

Type:SwitchParameter
Position:Named
Default value:False
Required: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
Required: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.

Érvényes értékek:

  • 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áulGet-Culture

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

Type:CultureInfo
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

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 további információkért lásd: $PSSessionOption 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ékétől függően változnak. Emellett a munkamenet-konfigurációs fájlt használó munkamenet-konfigurációk további tulajdonságokkal is rendelkeznek.