Udostępnij za pośrednictwem


New-PSSessionOption

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 w poleceniach cmdlet, które tworzą PSSession , takich jak New-PSSession, Enter-PSSessioni Invoke-Command.

Bez parametrów New-PSSessionOption generuje obiekt zawierający wartości domyślne dla wszystkich opcji. Ponieważ każda właściwość może być edytowana, 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 preferencji $PSSessionOption. Wartości tej zmiennej określają nowe wartości domyślne dla opcji sesji. Są skuteczne, gdy opcje sesji nie są ustawione i mają pierwszeństwo nad opcjami ustawionymi w konfiguracji sesji, ale można je zastąpić, określając opcje sesji lub obiektu SessionOption 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 SessionOption 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 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ę za pomocą 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 polecenia cmdlet New-PSSession do utworzenia sesji na komputerze zdalnym Server01. Polecenie używa obiektu SessionOption 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 nawiasami, aby upewnić się, że jest uruchomione 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ą preferencji $PSSessionOption.

$PSSessionOption = New-PSSessionOption -OpenTimeOut 120000

Gdy zmienna preferencji $PSSessionOption jest ustawiona w sesji, ustanawia domyślne wartości opcji w sesjach utworzonych za pomocą New-PSSession, Enter-PSSessioni Invoke-Command poleceń cmdlet.

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 SessionOption, 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 opcja SkipCNCheck jest wymagana.

Przykład 7: Udostępnij argumenty dla 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 SessionOption zapisany w zmiennej $team. Gdy New-PSSessionOption tworzy obiekt opcji sesji, automatycznie konwertuje tabelę skrótów w wartości parametru ApplicationArguments na PrimitiveDictionary, 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 PrimitiveDictionary, który jest wysyłany do sesji zdalnej. Polecenia i skrypty w sesji zdalnej, w tym skrypty startowe w konfiguracji sesji, mogą odnaleźć 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 operację anulowania (ctrl+C) przed zakończeniem. 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, która jest 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. Minimalna wartość 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.

Domyślna wartość IdleTimeoutMs w konfiguracji sesji Microsoft.PowerShell wynosi 7200000 milisekund (2 godziny). Jego wartość MaxIdleTimeoutMs jest 2147483647 milisekund (>24 dni). Domyślne ustawienie limitu czasu bezczynności powłoki WSMan (WSMan:\<ComputerName>\Shell\IdleTimeout) wynosi 7200000 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 jest 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 jest inne niż konto 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 SPN, na przykład używając Setspn.exe, i rejestrować je na różnych kontach użytkowników, rozróżniając je poprzez uwzględnienie numeru portu w SPN.

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 209715200 bajty (lub 200MB).

Typ:Int32
Position:Named
Domyślna wartość:209715200
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, jaki WinRM oczekuje na udane testy połączenia z aktywnego połączenia, zanim zainicjuje czas oczekiwania na połączenie. Aby uzyskać więcej informacji na temat usługi WinRM, zobacz Dokumentację Zarządzania Zdalnego Systemu Windows .

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

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

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 Block. Użytkownicy mogą również zmienić tryb buforowania danych wyjściowych podczas odłączania sesji.

Jeśli ten parametr zostanie pominięty, wartość OutputBufferingMode obiektu SessionOption jest None. Wartość Block lub Drop zastępuje opcję transportu trybu buforowania wyjściowego ustawioną w konfiguracji sesji. Dopuszczalne wartości tego parametru to:

  • Block. Gdy bufor wyjściowy jest zapełniony, wykonywanie jest zawieszone do momentu, gdy bufor jest wyczyszczony.
  • Drop. Gdy bufor wyjściowy jest pełny, wykonywanie będzie kontynuowane. W miarę zapisywania nowych danych wyjściowych najstarsze dane wyjściowe są odrzucane.
  • 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 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:

  • IEConfig
  • WinHttpConfig
  • AutoDetect
  • NoProxyServer
  • None

Wartość domyślna to None.

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
  • Digest
  • Negotiate

Wartość domyślna to Negotiate.

Aby uzyskać więcej informacji na temat wartości tego parametru, zobacz Wyliczenia Mechanizmów Uwierzytelniania.

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 danych uwierzytelnienia.

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.

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 potokować obiektów do tego polecenia cmdlet.

Dane wyjściowe

PSSessionOption

Uwagi

Jeśli parametr SessionOption nie jest używany w poleceniu tworzenia PSSession, opcje sesji bazują na wartościach 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.