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-PSSession
i 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-PSSession
i 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ładja-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
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.