New-PSSessionOption
Hiermee maakt u een object met geavanceerde opties voor een PSSession.
Syntaxis
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>] Description
De cmdlet New-PSSessionOption maakt een object met geavanceerde opties voor een door de gebruiker beheerde sessie (PSSession). U kunt het object gebruiken als de waarde van de parameter SessionOption van cmdlets die een PSSession-maken, zoals New-PSSession, Enter-PSSession en Invoke-Command.
Zonder parameters genereert New-PSSessionOption een object met de standaardwaarden voor alle opties. Omdat alle eigenschappen kunnen worden bewerkt, kunt u het resulterende object als sjabloon gebruiken en standaardoptieobjecten maken voor uw onderneming.
U kunt ook een sessieoptieobject opslaan in de $PSSessionOption voorkeursvariabele. Met de waarden van deze variabele worden nieuwe standaardwaarden voor de sessieopties ingesteld. Ze zijn effectief wanneer er geen sessieopties zijn ingesteld voor de sessie en ze voorrang hebben op opties die zijn ingesteld in de sessieconfiguratie, maar u kunt ze overschrijven door sessieopties of een sessieoptieobject op te geven in een cmdlet waarmee een sessie wordt gemaakt. Zie about_Preference_Variablesvoor meer informatie over de $PSSessionOption voorkeursvariabele.
Wanneer u een sessieoptieobject gebruikt in een cmdlet waarmee een sessie wordt gemaakt, hebben de waarden van de sessieoptie voorrang op standaardwaarden voor sessies die zijn ingesteld in de $PSSessionOption voorkeursvariabele en in de sessieconfiguratie. Ze hebben echter geen voorrang op maximumwaarden, quota of limieten die zijn ingesteld in de sessieconfiguratie. Zie about_Session_Configurationsvoor meer informatie over sessieconfiguraties.
Voorbeelden
Voorbeeld 1: Een standaardsessieoptie maken
Met deze opdracht maakt u een sessieoptieobject met alle standaardwaarden.
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:00Voorbeeld 2: Een sessie configureren met behulp van een sessieoptieobject
In dit voorbeeld ziet u hoe u een sessieoptieobject gebruikt om een sessie te configureren.
$pso = New-PSSessionOption -Culture "fr-fr" -MaximumReceivedObjectSize 10MB
New-PSSession -ComputerName Server01 -SessionOption $psoMet de eerste opdracht wordt een nieuw sessieoptieobject gemaakt en opgeslagen in de waarde van de $pso variabele. De tweede opdracht maakt gebruik van de New-PSSession cmdlet om een sessie te maken op de externe Server01-computer. De opdracht gebruikt het sessieoptieobject in de waarde van de $pso variabele als de waarde van de parameter SessionOption van de opdracht.
Voorbeeld 3: Een interactieve sessie starten
Met deze opdracht wordt de cmdlet Enter-PSSession gebruikt om een interactieve sessie met de Server01-computer te starten.
Enter-PSSession -ComputerName Server01 -SessionOption (New-PSSessionOption -NoEncryption -NoCompression)De waarde van de parameter SessionOption is een New-PSSessionOption opdracht met de parameters NoEncryption en NoCompression.
De New-PSSessionOption opdracht staat tussen haakjes om ervoor te zorgen dat deze wordt uitgevoerd vóór de opdracht Enter-PSSession.
Voorbeeld 4: Een sessieoptieobject wijzigen
In dit voorbeeld ziet u dat u het sessieoptieobject kunt wijzigen. Alle eigenschappen hebben lees-/schrijfwaarden.
$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:00Gebruik deze methode om een standaardsessieobject voor uw bedrijf te maken en vervolgens aangepaste versies ervan te maken voor bepaalde toepassingen.
Voorbeeld 5: Een voorkeursvariabele maken
Met deze opdracht maakt u een $PSSessionOption voorkeursvariabele.
$PSSessionOption = New-PSSessionOption -OpenTimeOut 120000Wanneer de $PSSessionOption voorkeursvariabele plaatsvindt in de sessie, worden standaardwaarden ingesteld voor opties in de sessies die worden gemaakt met behulp van de New-PSSession, Enter-PSSessionen Invoke-Command cmdlets.
Als u de $PSSessionOption variabele beschikbaar wilt maken in alle sessies, voegt u deze toe aan uw PowerShell-sessie en aan uw PowerShell-profiel.
Zie about_Preference_Variablesvoor meer informatie over de $PSSessionOption voorkeursvariabele.
Zie about_Profilesvoor meer informatie over profielen.
Voorbeeld 6: voldoen aan de vereisten voor een externe sessieconfiguratie
In dit voorbeeld ziet u hoe u een SessionOption--object gebruikt om te voldoen aan de vereisten voor een externe sessieconfiguratie.
$skipCN = New-PSSessionOption -SkipCNCheck
New-PSSession -ComputerName 171.09.21.207 -UseSSL -Credential Domain01\User01 -SessionOption $SkipCNDe eerste opdracht maakt gebruik van de cmdlet New-PSSessionOption om een sessieoptieobject te maken met de eigenschap SkipCNCheck. Met de opdracht wordt het resulterende sessieobject opgeslagen in de variabele $skipCN.
De tweede opdracht maakt gebruik van de New-PSSession cmdlet om een nieuwe sessie te maken op een externe computer. De $skipCN controlevariabele wordt gebruikt in de waarde van de parameter SessionOption.
Omdat de computer wordt geïdentificeerd door het IP-adres, komt de waarde van de parameter ComputerName niet overeen met een van de algemene namen in het certificaat dat wordt gebruikt voor SSL (Secure Sockets Layer). Als gevolg hiervan is de optie SkipCNCheck vereist.
Voorbeeld 7: Argumenten beschikbaar maken voor een externe sessie
In dit voorbeeld ziet u hoe u de parameter ApplicationArguments van de New-PSSessionOption-cmdlet gebruikt om extra gegevens beschikbaar te maken voor de externe sessie.
$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.Met de eerste opdracht maakt u een hash-tabel met twee sleutels, Team en Gebruik. Met de opdracht wordt de hash-tabel opgeslagen in de variabele $team. Zie about_Hash_Tablesvoor meer informatie over hashtabellen.
Vervolgens maakt de New-PSSessionOption-cmdlet met behulp van de parameter ApplicationArguments een sessieoptieobject dat is opgeslagen in de $team variabele. Wanneer New-PSSessionOption het sessieoptieobject maakt, wordt de hash-tabel automatisch geconverteerd in de waarde van de parameter ApplicationArguments naar een primitieve woordenlijst, zodat de gegevens betrouwbaar naar de externe sessie kunnen worden verzonden.
De cmdlet New-PSSession start een sessie op de Server01-computer. Hierbij wordt de parameter SessionOption gebruikt om de opties in de variabele $teamOption op te nemen.
De Invoke-Command cmdlet laat zien dat de gegevens in de $team variabele beschikbaar zijn voor opdrachten in de externe sessie. De gegevens worden weergegeven in de eigenschap ApplicationArguments van de automatische variabele $PSSenderInfo.
In de laatste Invoke-Command ziet u hoe de gegevens kunnen worden gebruikt.
Parameters
-ApplicationArguments
Hiermee geeft u een primitieve woordenlijst op die naar de externe sessie wordt verzonden. Opdrachten en scripts in de externe sessie, inclusief opstartscripts in de sessieconfiguratie, kunnen deze woordenlijst vinden in de eigenschap ApplicationArguments van de automatische variabele $PSSenderInfo. U kunt deze parameter gebruiken om gegevens naar de externe sessie te verzenden.
Zie about_Hash_Tables, about_Session_Configurationsen about_Automatic_Variablesvoor meer informatie.
| Type: | PSPrimitiveDictionary |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-CancelTimeout
Bepaalt hoe lang PowerShell wacht totdat een annuleringsbewerking (Ctrl+C) is voltooid voordat deze wordt beëindigd. Voer een waarde in milliseconden in.
De standaardwaarde is 60000 (één minuut). Een waarde van 0 (nul) betekent geen time-out; de opdracht voor onbepaalde tijd doorgaat.
| Type: | Int32 |
| Aliassen: | CancelTimeoutMSec |
| Position: | Named |
| Default value: | 60000 |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-Culture
Hiermee geeft u de cultuur die moet worden gebruikt voor de sessie. Voer een cultuurnaam in <languagecode2>-<country/regioncode2>-indeling (zoals ja-JP), een variabele die een CultureInfo-object bevat of een opdracht waarmee een CultureInfo object wordt opgehaald.
De standaardwaarde is $Nullen de cultuur die in het besturingssysteem is ingesteld, wordt gebruikt in de sessie.
| Type: | CultureInfo |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-IdleTimeout
Bepaalt hoe lang de sessie open blijft als de externe computer geen communicatie van de lokale computer ontvangt. Dit omvat het heartbeatsignaal. Wanneer het interval verloopt, wordt de sessie gesloten.
De time-outwaarde voor inactiviteit is van groot belang als u de verbinding met een sessie wilt verbreken en opnieuw verbinding wilt maken. U kunt alleen opnieuw verbinding maken als er geen time-out optreedt voor de sessie.
Voer een waarde in milliseconden in. De minimumwaarde is 60000 (1 minuut). Het maximum is de waarde van de MaxIdleTimeoutms eigenschap van de sessieconfiguratie. Met de standaardwaarde -1 wordt geen time-out voor inactiviteit ingesteld.
De sessie gebruikt de time-out voor inactiviteit die is ingesteld in de sessieopties, indien van toepassing. Als er geen is ingesteld (-1), gebruikt de sessie de waarde van de IdleTimeoutMs eigenschap van de sessieconfiguratie of de time-outwaarde van de WSMan-shell (WSMan:\<ComputerName>\Shell\IdleTimeout), afhankelijk van wat het kortst is.
Als de time-out voor inactiviteit in de sessieopties groter is dan de waarde van de MaxIdleTimeoutMs eigenschap van de sessieconfiguratie, mislukt de opdracht om een sessie te maken.
De IdleTimeoutMs waarde van de standaardconfiguratie Microsoft.PowerShell sessie is 7200000 milliseconden (2 uur). De waarde MaxIdleTimeoutMs is 2147483647 milliseconden (>24 dagen). De standaardwaarde van de time-out voor inactiviteit van de WSMan-shell (WSMan:\<ComputerName>\Shell\IdleTimeout) is 7200000 milliseconden (2 uur).
De time-outwaarde voor inactiviteit van een sessie kan ook worden gewijzigd wanneer de verbinding met een sessie wordt verbroken of opnieuw verbinding maakt met een sessie. Zie Disconnect-PSSession en Connect-PSSessionvoor meer informatie.
In Windows PowerShell 2.0 is de standaardwaarde van de parameter IdleTimeout 240000 (4 minuten).
| Type: | Int32 |
| Aliassen: | IdleTimeoutMSec |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-IncludePortInSPN
Bevat het poortnummer in de SPN (Service Principal Name) die wordt gebruikt voor Kerberos-verificatie, bijvoorbeeld HTTP://<ComputerName>:5985. Met deze optie kan een client die gebruikmaakt van een niet-standaard SPN verifiëren op een externe computer die gebruikmaakt van Kerberos-verificatie.
De optie is ontworpen voor ondernemingen waarbij meerdere services die Kerberos-verificatie ondersteunen, worden uitgevoerd onder verschillende gebruikersaccounts. Een IIS-toepassing die kerberos-verificatie toestaat, kan bijvoorbeeld vereisen dat de standaard-SPN wordt geregistreerd bij een gebruikersaccount dat verschilt van het computeraccount. In dergelijke gevallen kan externe communicatie van PowerShell Kerberos niet gebruiken om te verifiëren, omdat hiervoor een SPN is vereist die is geregistreerd bij het computeraccount. Om dit probleem op te lossen, kunnen beheerders verschillende SPN's maken, zoals met behulp van Setspn.exe, die zijn geregistreerd bij verschillende gebruikersaccounts en onderscheid kunnen maken tussen deze accounts door het poortnummer in de SPN op te geven.
Zie Setspn Overviewvoor meer informatie.
Deze parameter is geïntroduceerd in Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-MaxConnectionRetryCount
Hiermee geeft u het aantal keren op dat PowerShell probeert verbinding te maken met een doelcomputer als de huidige poging mislukt vanwege netwerkproblemen. De standaardwaarde is 5.
Deze parameter is toegevoegd voor PowerShell versie 5.0.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-MaximumReceivedDataSizePerCommand
Hiermee geeft u het maximum aantal bytes op dat de lokale computer kan ontvangen van de externe computer in één opdracht. Voer een waarde in bytes in. Standaard is er geen limiet voor de gegevensgrootte.
Deze optie is ontworpen om de resources op de clientcomputer te beveiligen.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-MaximumReceivedObjectSize
Hiermee geeft u de maximale grootte van een object dat de lokale computer kan ontvangen van de externe computer. Deze optie is ontworpen om de resources op de clientcomputer te beveiligen. Voer een waarde in bytes in.
Als u deze parameter weglaat in Windows PowerShell 2.0, is er geen limiet voor de objectgrootte. Vanaf Windows PowerShell 3.0 is de standaardwaarde 200 MB als u deze parameter weglaat.
| Type: | Int32 |
| Position: | Named |
| Default value: | 200 MB |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-MaximumRedirection
Bepaalt hoe vaak PowerShell een verbinding omleidt naar een alternatieve URI (Uniform Resource Identifier) voordat de verbinding mislukt. De standaardwaarde is 5. Een waarde van 0 (nul) voorkomt dat alle omleidingen worden omgeleid.
Deze optie wordt alleen in de sessie gebruikt wanneer de parameter AllowRedirection wordt gebruikt in de opdracht waarmee de sessie wordt gemaakt.
| Type: | Int32 |
| Position: | Named |
| Default value: | 5 |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-NoCompression
Hiermee schakelt u pakketcompressie in de sessie uit. Compressie maakt gebruik van meer processorcycli, maar het maakt transmissie sneller.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-NoEncryption
Hiermee schakelt u gegevensversleuteling uit.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-NoMachineProfile
Hiermee voorkomt u dat het Windows-gebruikersprofiel van de gebruiker wordt geladen. Hierdoor kan de sessie sneller worden gemaakt, maar gebruikersspecifieke registerinstellingen, items zoals omgevingsvariabelen en certificaten zijn niet beschikbaar in de sessie.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-OpenTimeout
Bepaalt hoe lang de clientcomputer wacht totdat de sessieverbinding tot stand is gebracht. Wanneer het interval verloopt, mislukt de opdracht om de verbinding tot stand te brengen. Voer een waarde in milliseconden in.
De standaardwaarde is 180000 (3 minuten). Een waarde van 0 (nul) betekent geen time-out; de opdracht voor onbepaalde tijd doorgaat.
| Type: | Int32 |
| Aliassen: | OpenTimeoutMSec |
| Position: | Named |
| Default value: | 180000 (3 minutes) |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-OperationTimeout
Bepaalt de maximale tijd waarop een bewerking in de sessie kan worden uitgevoerd. Wanneer het interval verloopt, mislukt de bewerking. Voer een waarde in milliseconden in.
De standaardwaarde is 180000 (3 minuten). Een waarde van 0 (nul) betekent geen time-out; de bewerking voor onbepaalde tijd wordt voortgezet.
| Type: | Int32 |
| Aliassen: | OperationTimeoutMSec |
| Position: | Named |
| Default value: | 180000 (3 minutes) |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-OutputBufferingMode
Bepaalt hoe opdrachtuitvoer wordt beheerd in niet-verbonden sessies wanneer de uitvoerbuffer vol raakt.
Als de uitvoerbuffermodus niet is ingesteld in de sessie of in de sessieconfiguratie, wordt de standaardwaarde Blokkeren. Gebruikers kunnen ook de uitvoerbuffermodus wijzigen wanneer de sessie wordt verbroken.
Als u deze parameter weglaat, is de waarde van de OutputBufferingMode van het sessieoptieobject Geen. Een waarde van Blokkeren of Neerzetten overschrijft de transportoptie voor de uitvoerbuffermodus die is ingesteld in de sessieconfiguratie. De acceptabele waarden voor deze parameter zijn:
- Blokkeren. Wanneer de uitvoerbuffer vol is, wordt de uitvoering onderbroken totdat de buffer leeg is.
- Druppel. Wanneer de uitvoerbuffer vol is, wordt de uitvoering voortgezet. Wanneer nieuwe uitvoer wordt opgeslagen, wordt de oudste uitvoer verwijderd.
- Geen. Er is geen uitvoerbuffermodus opgegeven.
Zie New-PSTransportOptionvoor meer informatie over de transportoptie uitvoerbuffermodus.
Deze parameter is geïntroduceerd in Windows PowerShell 3.0.
| Type: | OutputBufferingMode |
| Geaccepteerde waarden: | None, Drop, Block |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-ProxyAccessType
Bepaalt welk mechanisme wordt gebruikt om de hostnaam op te lossen. De acceptabele waarden voor deze parameter zijn:
- IE-configuratie
- WinHttpConfig
- AutoDetectie
- NoProxyServer
- Geen
De standaardwaarde is Geen.
Zie Opsomming ProxyAccessTypevoor meer informatie over de waarden van deze parameter.
| Type: | ProxyAccessType |
| Geaccepteerde waarden: | None, IEConfig, WinHttpConfig, AutoDetect, NoProxyServer |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-ProxyAuthentication
Hiermee geeft u de verificatiemethode op die wordt gebruikt voor proxyomzetting. De acceptabele waarden voor deze parameter zijn: Basic, Digesten Negotiate. De standaardwaarde is Negotiate.
Zie Opsomming AuthenticationMechanismvoor meer informatie over de waarden van deze parameter.
| Type: | AuthenticationMechanism |
| Geaccepteerde waarden: | Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos |
| Position: | Named |
| Default value: | Negotiate |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-ProxyCredential
Hiermee geeft u de referenties die moeten worden gebruikt voor proxyverificatie. Voer een variabele in die een PSCredential--object bevat of een opdracht waarmee een PSCredential--object wordt opgehaald, zoals een Get-Credential opdracht. Als deze optie niet is ingesteld, worden er geen referenties opgegeven.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-SkipCACheck
Hiermee geeft u op dat wanneer er verbinding wordt gemaakt via HTTPS, de client niet valideert dat het servercertificaat is ondertekend door een vertrouwde certificeringsinstantie (CA).
Gebruik deze optie alleen wanneer de externe computer wordt vertrouwd met een ander mechanisme, zoals wanneer de externe computer deel uitmaakt van een netwerk dat fysiek veilig en geïsoleerd is of wanneer de externe computer wordt vermeld als een vertrouwde host in een WinRM-configuratie.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-SkipCNCheck
Hiermee geeft u op dat de algemene naam van het certificaat (CN) van de server niet moet overeenkomen met de hostnaam van de server. Deze optie wordt alleen gebruikt in externe bewerkingen die gebruikmaken van het HTTPS-protocol.
Gebruik deze optie alleen voor vertrouwde computers.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-SkipRevocationCheck
Valideert de intrekkingsstatus van het servercertificaat niet.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-UICulture
Hiermee geeft u de UI-cultuur op die moet worden gebruikt voor de sessie.
Geldige waarden zijn:
- Een cultuurnaam in
<languagecode2>-<country/regioncode2>indeling, zoalsja-JP - Een variabele die een CultureInfo--object bevat
- Een opdracht waarmee een CultureInfo--object wordt opgehaald, zoals
Get-Culture
De standaardwaarde is $nullen de UI-cultuur die is ingesteld in het besturingssysteem wanneer de sessie wordt gemaakt, wordt gebruikt in de sessie.
| Type: | CultureInfo |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-UseUTF16
Geeft aan dat deze cmdlet de aanvraag in UTF16-indeling codeert in plaats van de UTF8-indeling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
Invoerwaarden
None
U kunt invoer voor deze cmdlet niet doorsluisen.
Uitvoerwaarden
Notities
Als de parameter SessionOption niet wordt gebruikt in een opdracht om een PSSession-te maken, worden de sessieopties bepaald door de eigenschapswaarden van de $PSSessionOption voorkeursvariabele, als deze is ingesteld. Zie about_Preference_Variablesvoor meer informatie over de variabele $PSSessionOption.
De eigenschappen van een sessieconfiguratieobject variëren met de opties die zijn ingesteld voor de sessieconfiguratie en de waarden van deze opties. Daarnaast hebben sessieconfiguraties die gebruikmaken van een sessieconfiguratiebestand aanvullende eigenschappen.