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 cmdlet New-PSSessionOption tworzy obiekt zawierający zaawansowane opcje sesji zarządzanej przez użytkownika (pssession). Można użyć obiektu jako wartości parametru SessionOption poleceń cmdlet, które tworzą PSSession, takie jak New-PSSession, Enter-PSSession i Invoke-Command.

Bez parametrów New-PSSessionOption generuje obiekt zawierający wartości domyślne dla wszystkich opcji. Ze względu na to, że wszystkie właściwości można edytować, możesz użyć wynikowego obiektu jako szablonu i utworzyć standardowe obiekty opcji dla przedsiębiorstwa.

Można również zapisać obiekt opcji sesji w zmiennej preferencji $PSSessionOption. Wartości tej zmiennej określają nowe wartości domyślne dla opcji sesji. Obowiązują one, 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 opcji sesji w poleceniu cmdlet, które tworzy sesję. Aby uzyskać więcej informacji na temat zmiennej preferencji $PSSessionOption, zobacz about_Preference_Variables.

W przypadku używania obiektu opcji sesji w poleceniu cmdlet tworzącym sesję wartości opcji sesji mają pierwszeństwo przed wartościami domyślnymi sesji ustawionymi w zmiennej preferencji $PSSessionOption i w konfiguracji sesji. Nie mają jednak pierwszeństwa przed maksymalnymi wartościami, limitami przydziału lub limitami ustawionymi w konfiguracji sesji. Aby uzyskać więcej informacji na temat konfiguracji sesji, zobacz about_Session_Configurations.

Przykłady

Przykład 1. Tworzenie opcji sesji domyślnej

To polecenie tworzy obiekt opcji sesji, który ma wszystkie wartości domyślne.

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ę za pomocą obiektu opcji sesji.

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

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

Przykład 3. Uruchamianie sesji interakcyjnej

To polecenie używa polecenia cmdlet Enter-PSSession, aby uruchomić interaktywną sesję z komputerem Server01.

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

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

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

Przykład 4. Modyfikowanie obiektu opcji sesji

W tym przykładzie pokazano, że można zmodyfikować obiekt opcji sesji. 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ą preferencji $PSSessionOption.

$PSSessionOption = New-PSSessionOption -OpenTimeOut 120000

Gdy zmienna preferencji $PSSessionOption występuje w sesji, ustanawia domyślne wartości opcji w sesjach tworzonych przy użyciu poleceń cmdlet New-PSSession, 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 preferencji $PSSessionOption, 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 używać obiektu SessionOption w celu spełnienia wymagań dotyczących konfiguracji sesji zdalnej.

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

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

Drugie polecenie używa polecenia cmdlet New-PSSession do utworzenia nowej sesji na komputerze zdalnym. Zmienna sprawdzania $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 użyć parametru ApplicationArguments polecenia cmdlet New-PSSessionOption, aby 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.

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

Polecenie cmdlet New-PSSession uruchamia sesję na komputerze Server01. Używa parametru SessionOption do uwzględnienia opcji w zmiennej $teamOption.

Polecenie cmdlet Invoke-Command 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.

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

Parametry

-ApplicationArguments

Określa słownik pierwotny, 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 w ApplicationArguments właściwości $PSSenderInfo zmiennej automatycznej. Tego parametru można użyć do wysyłania danych do sesji zdalnej.

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

Typ:	PSPrimitiveDictionary
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-CancelTimeout

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

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

Typ:	Int32
Aliasy:	CancelTimeoutMSec
Position:	Named
Domyślna wartość:	60000
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Culture

Określa kulturę, która ma być używana dla sesji. Wprowadź nazwę kultury w formacie <languagecode2>-<country/regioncode2> (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.

Typ:	CultureInfo
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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 istotne 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 -1 nie ustawia limitu czasu bezczynności.

Sesja używa limitu czasu bezczynności ustawionego w opcjach sesji, jeśli istnieje. Jeśli parametr none is set (-1), sesja używa wartości IdleTimeoutMs właściwości 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ść MaxIdleTimeoutMs właściwości konfiguracji sesji, polecenie tworzenia sesji zakończy się niepowodzeniem.

Wartość IdleTimeoutMs domyślnej konfiguracji sesji Microsoft.PowerShell to 72000000 ms (2 godziny). Jego wartość MaxIdleTimeoutMs jest 2147483647 milisekund (>24 dni). Wartość domyślna limitu czasu bezczynności powłoki WSMan (WSMan:\<ComputerName>\Shell\IdleTimeout) wynosi 72000000 milisekund (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 programie Windows PowerShell 2.0 wartość domyślna parametru IdleTimeout wynosi 240000 (4 minuty).

Typ:	Int32
Aliasy:	IdleTimeoutMSec
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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.exe, które są zarejestrowane na różnych kontach użytkowników i mogą je rozróżnić, uwzględniając numer portu w głównej nazwie usługi.

Aby uzyskać więcej informacji, zobacz Setspn Overview.

Ten parametr został wprowadzony w programie Windows PowerShell 3.0.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-MaxConnectionRetryCount

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

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

Typ:	Int32
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-MaximumReceivedDataSizePerCommand

Określa maksymalną liczbę bajtów, które 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.

Typ:	Int32
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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 programie Windows PowerShell 2.0, jeśli pominięto ten parametr, nie ma limitu rozmiaru obiektu. Począwszy od programu Windows PowerShell 3.0, jeśli pominięto ten parametr, wartość domyślna to 200 MB.

Typ:	Int32
Position:	Named
Domyślna wartość:	200 MB
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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 wszystkie przekierowania.

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

Typ:	Int32
Position:	Named
Domyślna wartość:	5
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-NoCompression

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

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-NoEncryption

Wyłącza szyfrowanie danych.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-OpenTimeout

Określa, jak długo komputer kliencki czeka na nawiązanie połączenia sesji. Po wygaśnięciu interwału polecenie nawiązywania 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 w nieskończoność.

Typ:	Int32
Aliasy:	OpenTimeoutMSec
Position:	Named
Domyślna wartość:	180000 (3 minutes)
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-OperationTimeout

Określa maksymalny czas uruchomienia dowolnej operacji w sesji. Po wygaśnięciu interwału operacja kończy się niepowodzeniem. Wprowadź wartość w milisekundach.

Wartość domyślna to 180000 (3 minuty). Wartość 0 (zero) oznacza brak limitu czasu; operacja jest kontynuowana w nieskończoność.

Typ:	Int32
Aliasy:	OperationTimeoutMSec
Position:	Named
Domyślna wartość:	180000 (3 minutes)
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-OutputBufferingMode

Określa sposób zarządzania danymi wyjściowymi poleceń w rozłączonych sesjach, gdy bufor wyjściowy staje się pełny.

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

Jeśli pominięto ten parametr, wartość OutputBufferingMode obiektu opcji sesji to Brak. Wartość Block or Drop zastępuje opcję transportu trybu buforowania wyjściowego ustawioną w konfiguracji sesji. Dopuszczalne wartości tego parametru to:

Blok. Gdy bufor wyjściowy jest zapełniony, wykonywanie jest zawieszone do momentu, gdy bufor jest wyczyszczone.
Kropla. Gdy bufor wyjściowy jest pełny, wykonywanie będzie kontynuowane. W miarę zapisywania nowych danych wyjściowych najstarsze dane wyjściowe są odrzucane.
Żaden. 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 programie Windows PowerShell 3.0.

Typ:	OutputBufferingMode
Dopuszczalne wartości:	None, Drop, Block
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ProxyAccessType

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

Konfiguracja programu IE
WinHttpConfig
Autowykrywanie
NoProxyServer
Żaden

Wartość domyślna to Brak.

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

Typ:	ProxyAccessType
Dopuszczalne wartości:	None, IEConfig, WinHttpConfig, AutoDetect, NoProxyServer
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ProxyAuthentication

Określa metodę uwierzytelniania używaną do rozpoznawania serwera proxy. Dopuszczalne wartości tego parametru to: Basic, Digesti Negotiate. Wartość domyślna to Negotiate.

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

Typ:	AuthenticationMechanism
Dopuszczalne wartości:	Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Position:	Named
Domyślna wartość:	Negotiate
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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 polecenie Get-Credential. Jeśli ta opcja nie jest ustawiona, nie określono poświadczeń.

Typ:	PSCredential
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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.

Tej opcji należy używać 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.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-SkipCNCheck

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

Użyj tej opcji tylko dla zaufanych komputerów.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-SkipRevocationCheck

Nie weryfikuje stanu odwołania certyfikatu serwera.

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	False
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-UICulture

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

Prawidłowe wartości to:

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

Wartość domyślna to $null, a kultura interfejsu użytkownika ustawiona w systemie operacyjnym podczas tworzenia sesji jest używana w sesji.

Typ:	CultureInfo
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-UseUTF16

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

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	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 PSSession, opcje sesji są określane przez wartości właściwości zmiennej preferencji $PSSessionOption, 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.

Udostępnij za pośrednictwem

New-PSSessionOption

Składnia

Opis

Przykłady

Przykład 1. Tworzenie opcji sesji domyślnej

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

Przykład 3. Uruchamianie sesji interakcyjnej

Przykład 4. Modyfikowanie obiektu opcji sesji

Przykład 5. Tworzenie zmiennej preferencji

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

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

Parametry

-ApplicationArguments

-CancelTimeout

-Culture

-IdleTimeout

-IncludePortInSPN

-MaxConnectionRetryCount

-MaximumReceivedDataSizePerCommand

-MaximumReceivedObjectSize

-MaximumRedirection

-NoCompression

-NoEncryption

-NoMachineProfile

-OpenTimeout

-OperationTimeout

-OutputBufferingMode

-ProxyAccessType

-ProxyAuthentication

-ProxyCredential

-SkipCACheck

-SkipCNCheck

-SkipRevocationCheck

-UICulture

-UseUTF16

Dane wejściowe

Dane wyjściowe

Uwagi

Dodatkowe zasoby

Udostępnij za pośrednictwem

New-PSSessionOption

Składnia

Opis

Przykłady

Przykład 1. Tworzenie opcji sesji domyślnej

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

Przykład 3. Uruchamianie sesji interakcyjnej

Przykład 4. Modyfikowanie obiektu opcji sesji

Przykład 5. Tworzenie zmiennej preferencji

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

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

Parametry

-ApplicationArguments

-CancelTimeout

-Culture

-IdleTimeout

-IncludePortInSPN

-MaxConnectionRetryCount

-MaximumReceivedDataSizePerCommand

-MaximumReceivedObjectSize

-MaximumRedirection

-NoCompression

-NoEncryption

-NoMachineProfile

-OpenTimeout

-OperationTimeout

-OutputBufferingMode

-ProxyAccessType

-ProxyAuthentication

-ProxyCredential

-SkipCACheck

-SkipCNCheck

-SkipRevocationCheck

-UICulture

-UseUTF16

Dane wejściowe

Dane wyjściowe

Uwagi

Linki powiązane

Dodatkowe zasoby