New-PSSessionOption

Odwołanie

Moduł:: Microsoft.PowerShell.Core

Tworzy obiekt zawierający zaawansowane opcje dla programu PSSession.

Składnia

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>]

Opis

Polecenie New-PSSessionOption cmdlet tworzy obiekt zawierający zaawansowane opcje sesji zarządzanej przez użytkownika (PSSession). Możesz użyć obiektu jako wartości parametru SessionOption poleceń cmdlet, które tworzą sesję PSSession, taką jak New-PSSession, Enter-PSSessioni Invoke-Command.

Bez parametrów New-PSSessionOption generuje obiekt, który zawiera wartości domyślne dla wszystkich opcji. Ponieważ każdą właściwość można edytować, można użyć wynikowego obiektu jako szablonu i utworzyć standardowe obiekty opcji dla przedsiębiorstwa.

Można również zapisać obiekt SessionOption w zmiennej $PSSessionOption preferencji. Wartości tej zmiennej ustanawiają nowe wartości domyślne dla opcji sesji. Są one skuteczne, gdy dla sesji nie są ustawione żadne opcje sesji i mają pierwszeństwo przed opcjami ustawionymi w konfiguracji sesji, ale można je zastąpić, określając opcje sesji lub obiekt SessionOption w poleceniu cmdlet, które tworzy sesję. Aby uzyskać więcej informacji na temat zmiennej $PSSessionOption preferencji, zobacz about_Preference_Variables.

Jeśli używasz obiektu SessionOption w poleceniu cmdlet, które tworzy sesję, wartości opcji sesji mają pierwszeństwo przed wartościami domyślnymi dla sesji ustawionych w $PSSessionOption zmiennej preferencji i w konfiguracji sesji. Nie mają jednak pierwszeństwa przed maksymalnymi wartościami, limitami przydziału ani limitami ustawionymi w konfiguracji sesji. Aby uzyskać więcej informacji na temat konfiguracji sesji, zobacz Informacje o konfiguracjach sesji.

Przykłady

Przykład 1. Tworzenie opcji sesji domyślnej

To polecenie tworzy obiekt SessionOption z wartościami domyślnymi.

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

Przykład 2. Konfigurowanie sesji przy użyciu obiektu opcji sesji

W tym przykładzie pokazano, jak skonfigurować sesję przy użyciu obiektu SessionOption .

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

Pierwsze polecenie tworzy nowy obiekt SessionOption i zapisuje go w wartości zmiennej $pso . Drugie polecenie używa New-PSSession polecenia cmdlet do utworzenia sesji na komputerze zdalnym Server01. Polecenie używa obiektu SessionOption w wartości $pso zmiennej jako wartości parametru SessionOption polecenia.

Przykład 3. Uruchamianie sesji interakcyjnej

To polecenie używa Enter-PSSession polecenia cmdlet do uruchomienia sesji interakcyjnej z komputerem Server01.

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

Wartość parametru SessionOption to New-PSSessionOption polecenie z parametrami NoEncryption i NoCompression .

Polecenie New-PSSessionOption jest ujęte w nawiasy, aby upewnić się, że jest ono uruchamiane przed poleceniem Enter-PSSession .

Przykład 4. Modyfikowanie obiektu opcji sesji

W tym przykładzie pokazano, że można zmodyfikować obiekt SessionOption . Wszystkie właściwości mają wartości odczytu/zapisu.

$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

Użyj tej metody, aby utworzyć standardowy obiekt sesji dla przedsiębiorstwa, a następnie utworzyć dostosowane wersje dla określonych zastosowań.

Przykład 5. Tworzenie zmiennej preferencji

To polecenie tworzy zmienną $PSSessionOption preferencji.

$PSSessionOption = New-PSSessionOption -OpenTimeOut 120000

Gdy zmienna $PSSessionOption preferencji jest ustawiana w sesji, ustanawia wartości domyślne dla opcji w sesjach tworzonych za pomocą New-PSSessionpoleceń cmdlet , Enter-PSSessioni Invoke-Command .

Aby udostępnić zmienną $PSSessionOption we wszystkich sesjach, dodaj ją do sesji programu PowerShell i do profilu programu PowerShell.

Aby uzyskać więcej informacji na temat zmiennej $PSSessionOption preferencji, zobacz about_Preference_Variables. Aby uzyskać więcej informacji na temat profilów, zobacz about_Profiles.

Przykład 6: Spełnianie wymagań dotyczących konfiguracji sesji zdalnej

W tym przykładzie pokazano, jak za pomocą obiektu SessionOption spełnić wymagania dotyczące konfiguracji sesji zdalnej.

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

Pierwsze polecenie używa New-PSSessionOption polecenia cmdlet do utworzenia obiektu SessionOption , który ma właściwość SkipCNCheck . Polecenie zapisuje wynikowy obiekt sesji w zmiennej $skipCN .

Drugie polecenie używa New-PSSession polecenia cmdlet do utworzenia nowej sesji na komputerze zdalnym. Zmienna kontrolna $skipCN jest używana w wartości parametru SessionOption .

Ponieważ komputer jest identyfikowany przez jego adres IP, wartość parametru ComputerName nie jest zgodna z żadną z nazw pospolitych w certyfikacie używanym dla protokołu SSL (Secure Sockets Layer). W związku z tym wymagana jest opcja SkipCNCheck .

Przykład 7. Udostępnianie argumentów sesji zdalnej

W tym przykładzie pokazano, jak za pomocą parametru New-PSSessionOptionApplicationArguments polecenia cmdlet udostępnić dodatkowe dane sesji zdalnej.

$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.

Pierwsze polecenie tworzy tabelę skrótów z dwoma kluczami: Team i Use. Polecenie zapisuje tabelę skrótów w zmiennej $team . Aby uzyskać więcej informacji na temat tabel skrótów, zobacz about_Hash_Tables.

New-PSSessionOption Następnie polecenie cmdlet przy użyciu parametru ApplicationArguments tworzy obiekt SessionOption zapisany w zmiennej$team. Podczas New-PSSessionOption tworzenia obiektu opcji sesji automatycznie konwertuje tabelę skrótów w wartości parametru ApplicationArguments na element PrimitiveDictionary , aby dane mogły być niezawodnie przesyłane do sesji zdalnej.

Polecenie New-PSSession cmdlet uruchamia sesję na komputerze Server01. Używa parametru SessionOption , aby uwzględnić opcje w zmiennej $teamOption .

Polecenie Invoke-Command cmdlet pokazuje, że dane w zmiennej $team są dostępne dla poleceń w sesji zdalnej. Dane są wyświetlane we właściwości ApplicationArguments zmiennej automatycznej $PSSenderInfo .

Invoke-Command Ostatni pokazuje, jak mogą być używane dane.

Parametry

-ApplicationArguments

Określa element PrimitiveDictionary , który jest wysyłany do sesji zdalnej. Polecenia i skrypty w sesji zdalnej, w tym skrypty uruchamiania w konfiguracji sesji, mogą znaleźć ten słownik we właściwości ApplicationArguments zmiennej automatycznej $PSSenderInfo . Tego parametru można użyć do wysyłania danych do sesji zdalnej.

Aby uzyskać więcej informacji, zobacz about_Hash_Tables, about_Session_Configurations i about_Automatic_Variables.

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

-CancelTimeout

Określa, jak długo program PowerShell czeka na zakończenie operacji anulowania (CTRL+C) przed jej zakończeniem. Wprowadź wartość w milisekundach.

Wartość domyślna to 60000 (jedna minuta). Wartość 0 (zero) oznacza brak limitu czasu; polecenie jest kontynuowane w nieskończoność.

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

-Culture

Określa kulturę, która ma być używana dla sesji. Wprowadź nazwę kultury w <languagecode2>-<country/regioncode2> formacie (na przykład ja-JP), zmienną zawierającą obiekt CultureInfo lub polecenie, które pobiera obiekt CultureInfo .

Wartość domyślna to $Null, a kultura ustawiona w systemie operacyjnym jest używana w sesji.

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

-IdleTimeout

Określa, jak długo sesja pozostaje otwarta, jeśli komputer zdalny nie odbiera żadnej komunikacji z komputera lokalnego. Obejmuje to sygnał pulsu. Po wygaśnięciu interwału sesja zostanie zamknięta.

Wartość limitu czasu bezczynności ma znaczącą znaczenie, jeśli zamierzasz odłączyć się i ponownie nawiązać połączenie z sesją. Możesz ponownie nawiązać połączenie tylko wtedy, gdy sesja nie przekroczyła limitu czasu.

Wprowadź wartość w milisekundach. Wartość minimalna to 60000 (1 minuta). Wartość maksymalna to wartość właściwości MaxIdleTimeoutms konfiguracji sesji. Wartość domyślna , -1nie ustawia limitu czasu bezczynności.

Sesja używa limitu czasu bezczynności ustawionego w opcjach sesji, jeśli istnieje. Jeśli parametr none nie jest ustawiony (-1), sesja używa wartości właściwości IdleTimeoutMs konfiguracji sesji lub wartości limitu czasu powłoki WSMan (WSMan:\<ComputerName>\Shell\IdleTimeout), w zależności od tego, która wartość jest najkrótsza.

Jeśli limit czasu bezczynności ustawiony w opcjach sesji przekracza wartość właściwości MaxIdleTimeoutMs konfiguracji sesji, polecenie tworzenia sesji kończy się niepowodzeniem.

Wartość IdleTimeoutMs domyślnej konfiguracji sesji Microsoft.PowerShell to 7200000 milisekundy (2 godziny). Jego wartość MaxIdleTimeoutMs to 2147483647 milisekundy (>24 dni). Wartość domyślna limitu czasu bezczynności powłoki WSMan (WSMan:\<ComputerName>\Shell\IdleTimeout) to 7200000 milisekundy (2 godziny).

Wartość limitu czasu bezczynności sesji można również zmienić podczas odłączania od sesji lub ponownego nawiązywania połączenia z sesją. Aby uzyskać więcej informacji, zobacz Disconnect-PSSession i Connect-PSSession.

W Windows PowerShell 2.0 wartość domyślna parametru IdleTimeout wynosi 240000 (4 minuty).

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

-IncludePortInSPN

Zawiera numer portu w głównej nazwie usługi (SPN) używanej do uwierzytelniania Kerberos, na przykład HTTP://<ComputerName>:5985. Ta opcja umożliwia klientowi, który używa innej niż domyślna nazwa SPN do uwierzytelniania na komputerze zdalnym korzystającym z uwierzytelniania Kerberos.

Ta opcja jest przeznaczona dla przedsiębiorstw, w których wiele usług obsługujących uwierzytelnianie Kerberos działa w ramach różnych kont użytkowników. Na przykład aplikacja USŁUG IIS, która umożliwia uwierzytelnianie Kerberos, może wymagać zarejestrowania domyślnej nazwy SPN na koncie użytkownika, które różni się od konta komputera. W takich przypadkach komunikacja zdalna programu PowerShell nie może używać protokołu Kerberos do uwierzytelniania, ponieważ wymaga nazwy SPN zarejestrowanej na koncie komputera. Aby rozwiązać ten problem, administratorzy mogą tworzyć różne nazwy SPN, takie jak przy użyciu Setspn.exepolecenia , które są zarejestrowane na różnych kontach użytkowników i mogą rozróżniać je, uwzględniając numer portu w nazwie SPN.

Aby uzyskać więcej informacji, zobacz Setspn Overview (Omówienie programu Setspn).

Ten parametr został wprowadzony w Windows PowerShell 3.0.

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

-MaxConnectionRetryCount

Określa liczbę prób nawiązania połączenia z maszyną docelową przez program PowerShell, jeśli bieżąca próba nie powiedzie się z powodu problemów z siecią. Wartość domyślna to 5.

Ten parametr został dodany dla programu PowerShell w wersji 5.0.

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

-MaximumReceivedDataSizePerCommand

Określa maksymalną liczbę bajtów, którą komputer lokalny może odbierać z komputera zdalnego w jednym poleceniu. Wprowadź wartość w bajtach. Domyślnie nie ma limitu rozmiaru danych.

Ta opcja jest przeznaczona do ochrony zasobów na komputerze klienckim.

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

-MaximumReceivedObjectSize

Określa maksymalny rozmiar obiektu, który komputer lokalny może odbierać z komputera zdalnego. Ta opcja jest przeznaczona do ochrony zasobów na komputerze klienckim. Wprowadź wartość w bajtach.

W Windows PowerShell 2.0, jeśli pominięto ten parametr, nie ma limitu rozmiaru obiektu. Począwszy od Windows PowerShell 3.0, jeśli pominięto ten parametr, wartość domyślna to 200.

Type:	Int32
Position:	Named
Default value:	200 MB
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaximumRedirection

Określa, ile razy program PowerShell przekierowuje połączenie z alternatywnym identyfikatorem URI (Uniform Resource Identifier) przed niepowodzeniem połączenia. Wartość domyślna to 5. Wartość 0 (zero) uniemożliwia przekierowanie.

Ta opcja jest używana w sesji tylko wtedy, gdy parametr AllowRedirection jest używany w poleceniu, które tworzy sesję.

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

-NoCompression

Wyłącza kompresję pakietów w sesji. Kompresja używa większej liczby cykli procesora, ale przyspiesza transmisję.

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

-NoEncryption

Wyłącza szyfrowanie danych.

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

-NoMachineProfile

Uniemożliwia ładowanie profilu użytkownika systemu Windows. W związku z tym sesja może zostać utworzona szybciej, ale ustawienia rejestru specyficzne dla użytkownika, elementy, takie jak zmienne środowiskowe i certyfikaty, nie są dostępne w sesji.

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

-OpenTimeout

Określa, jak długo komputer kliencki czeka na nawiązanie połączenia sesji. Po wygaśnięciu interwału polecenie ustanowienia połączenia kończy się niepowodzeniem. Wprowadź wartość w milisekundach.

Wartość domyślna to 180000 (3 minuty). Wartość 0 (zero) oznacza brak limitu czasu; polecenie jest kontynuowane na czas nieokreślony.

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

-OperationTimeout

Określa maksymalny czas oczekiwania usługi WinRM na dodatnie testy połączeń z połączenia na żywo przed zainicjowaniem limitu czasu połączenia. Aby uzyskać więcej informacji na temat usługi WinRM, zobacz dokumentację zarządzania zdalnego systemu Windows.

OperacjaTimeoutnie nakłada limitu czasu na polecenia lub procesy uruchomione w sesji zdalnej i nie ma wpływu na inne protokoły komunikacji zdalnej, takie jak SSH.

Wartość domyślna to 180000 (3 minuty). Wartość 0 (zero) oznacza brak limitu czasu.

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

-OutputBufferingMode

Określa sposób zarządzania danymi wyjściowymi poleceń w rozłączonych sesjach po zapełnieniu buforu wyjściowego.

Jeśli tryb buforowania danych wyjściowych nie jest ustawiony w sesji lub w konfiguracji sesji, wartość domyślna to Block. Użytkownicy mogą również zmienić tryb buforowania danych wyjściowych podczas odłączania sesji.

W przypadku pominięcia tego parametru wartość outputBufferingMode obiektu SessionOption to None. Wartość Block lub Drop zastępuje opcję transportu w trybie buforowania danych wyjściowych ustawioną w konfiguracji sesji. Dopuszczalne wartości dla tego parametru to:

Block. Gdy bufor wyjściowy jest pełny, wykonanie jest zawieszone do momentu wyczyszczenia buforu.
Drop. Gdy bufor wyjściowy jest pełny, wykonywanie będzie kontynuowane. Po zapisaniu nowych danych wyjściowych najstarsze dane wyjściowe zostaną odrzucone.
None. Nie określono trybu buforowania danych wyjściowych.

Aby uzyskać więcej informacji na temat opcji transportu trybu buforowania wyjściowego, zobacz New-PSTransportOption.

Ten parametr został wprowadzony w Windows PowerShell 3.0.

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

-ProxyAccessType

Określa, który mechanizm jest używany do rozpoznawania nazwy hosta. Dopuszczalne wartości dla tego parametru to:

IEConfig
WinHttpConfig
AutoDetect
NoProxyServer
None

Wartość domyślna to None.

Aby uzyskać informacje o wartościach tego parametru, zobacz ProxyAccessType, wyliczenie.

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

Określa metodę uwierzytelniania używaną do rozpoznawania serwera proxy. Dopuszczalne wartości dla tego parametru to:

Basic
Digest
Negotiate

Wartość domyślna to Negotiate.

Aby uzyskać więcej informacji na temat wartości tego parametru, zobacz AuthenticationMechanism Enumeration (Wyliczenie AuthenticationMechanism).

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

Określa poświadczenia do użycia na potrzeby uwierzytelniania serwera proxy. Wprowadź zmienną zawierającą obiekt PSCredential lub polecenie, które pobiera obiekt PSCredential , na przykład Get-Credential polecenie. Jeśli ta opcja nie jest ustawiona, nie określono poświadczeń.

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

-SkipCACheck

Określa, że po nawiązaniu połączenia za pośrednictwem protokołu HTTPS klient nie sprawdza, czy certyfikat serwera jest podpisany przez zaufany urząd certyfikacji (CA).

Użyj tej opcji tylko wtedy, gdy komputer zdalny jest zaufany przy użyciu innego mechanizmu, takiego jak gdy komputer zdalny jest częścią sieci, która jest fizycznie bezpieczna i izolowana lub gdy komputer zdalny jest wymieniony jako zaufany host w konfiguracji usługi WinRM.

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

-SkipCNCheck

Określa, że nazwa pospolita certyfikatu serwera nie musi być zgodna z nazwą hosta serwera. Ta opcja jest używana tylko w operacjach zdalnych korzystających z protokołu HTTPS.

Ta opcja jest używana tylko dla zaufanych komputerów.

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

-SkipRevocationCheck

Nie weryfikuje stanu odwołania certyfikatu serwera.

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

-UICulture

Określa kulturę interfejsu użytkownika do użycia dla sesji.

Prawidłowe wartości to:

Nazwa kultury w <languagecode2>-<country/regioncode2> formacie, na przykład ja-JP
Zmienna zawierająca obiekt CultureInfo
Polecenie, które pobiera obiekt CultureInfo , na przykład Get-Culture

Wartość domyślna to $null, a kultura interfejsu użytkownika ustawiona w systemie operacyjnym po utworzeniu sesji.

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

-UseUTF16

Wskazuje, że to polecenie cmdlet koduje żądanie w formacie UTF16 zamiast formatu UTF8.

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

Dane wejściowe

None

Nie można przekazać danych wejściowych potoku do tego polecenia cmdlet.

Dane wyjściowe

PSSessionOption

Uwagi

Jeśli parametr SessionOption nie jest używany w poleceniu do utworzenia sesji PSSession, opcje sesji są określane przez wartości $PSSessionOption właściwości zmiennej preferencji, jeśli jest ustawiona. Aby uzyskać więcej informacji na temat zmiennej $PSSessionOption , zobacz about_Preference_Variables.

Właściwości obiektu konfiguracji sesji różnią się w zależności od opcji ustawionych dla konfiguracji sesji i wartości tych opcji. Ponadto konfiguracje sesji korzystające z pliku konfiguracji sesji mają dodatkowe właściwości.