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 New-PSSessionOption cmdlet 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-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 $PSSessionOption preferencji. Wartości tej zmiennej określają nowe wartości domyślne dla opcji sesji. Są 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.

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 $PSSessionOption zmiennej preferencji 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 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ę 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 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 interaktywnej 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 ustawiona 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-PSSessionOption ApplicationArguments 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 , dzięki czemu dane mogą 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 .

W finale Invoke-Command pokazano, 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.

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) przed jego 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ść.

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

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 , -1nie ustawia limitu czasu bezczynności.

Sesja używa limitu czasu bezczynności ustawionego w opcjach sesji, jeśli istnieje. Jeśli żadna z nich nie jest ustawiona (-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 zakoń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 tematy Disconnect-PSSession oraz 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 programu Setspn.exe, które są zarejestrowane na różnych kontach użytkowników i mogą je rozróżniać, uwzględniając numer portu w głównej nazwie usługi.

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

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ą. Domyślna wartość 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. Domyślna wartość 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 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.

OperationTimeout nie 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.

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.

W przypadku pominięcia tego parametru wartość parametru OutputBufferingMode obiektu SessionOption to 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 wyczyszczone.
  • 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 w trybie 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

Domyślna wartość to None.

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

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

Domyślna wartość to Negotiate.

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

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 Get-Credential polecenie. 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 <languagecode2>-<country/regioncode2> formacie, takim jak 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 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 do utworzenia 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.