New-PSSessionOption

Syntax

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

Cmdleten New-PSSessionOption skapar ett objekt som innehåller avancerade alternativ för en användarhanterad session (PSSession). Du kan använda objektet som värdet för parametern SessionOption för cmdletar som skapar en PSSession-, till exempel New-PSSession, Enter-PSSession och Invoke-Command.

Utan parametrar genererar New-PSSessionOption ett objekt som innehåller standardvärdena för alla alternativ. Eftersom alla egenskaper kan redigeras kan du använda det resulterande objektet som en mall och skapa standardalternativobjekt för företaget.

Du kan också spara ett sessionsalternativobjekt i $PSSessionOption inställningsvariabeln. Värdena för den här variabeln etablerar nya standardvärden för sessionsalternativen. De gäller när inga sessionsalternativ har angetts för sessionen och de har företräde framför de alternativ som anges i sessionskonfigurationen, men du kan åsidosätta dem genom att ange sessionsalternativ eller ett sessionsalternativobjekt i en cmdlet som skapar en session. Mer information om $PSSessionOption-inställningsvariabeln finns i about_Preference_Variables.

När du använder ett sessionsalternativobjekt i en cmdlet som skapar en session har sessionsalternativvärdena företräde framför standardvärdena för sessioner som anges i $PSSessionOption-inställningsvariabeln och i sessionskonfigurationen. De har dock inte företräde framför de högsta värden, kvoter eller gränser som anges i sessionskonfigurationen. Mer information om sessionskonfigurationer finns i about_Session_Configurations.

Exempel

Exempel 1: Skapa ett standardalternativ för sessioner

Det här kommandot skapar ett sessionsalternativobjekt som har alla standardvärden.

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

Exempel 2: Konfigurera en session med hjälp av ett sessionsalternativobjekt

Det här exemplet visar hur du använder ett sessionsalternativobjekt för att konfigurera en session.

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

Det första kommandot skapar ett nytt sessionsalternativobjekt och sparar det i värdet för variabeln $pso. Det andra kommandot använder cmdleten New-PSSession för att skapa en session på server01-fjärrdatorn. Kommandot använder sessionsalternativobjektet i värdet för variabeln $pso som värdet för parametern SessionOption för kommandot.

Exempel 3: Starta en interaktiv session

Det här kommandot använder cmdleten Enter-PSSession för att starta en interaktiv session med Server01-datorn.

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

Värdet för parametern SessionOption är ett New-PSSessionOption kommando som har parametrarna NoEncryption och NoCompression.

Kommandot New-PSSessionOption omges av parenteser för att se till att det körs före kommandot Enter-PSSession.

Exempel 4: Ändra ett sessionsalternativobjekt

Det här exemplet visar att du kan ändra sessionsalternativobjektet. Alla egenskaper har läs-/skrivvärden.

$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

Använd den här metoden för att skapa ett standardsessionsobjekt för ditt företag och skapa sedan anpassade versioner av det för specifika användningsområden.

Exempel 5: Skapa en inställningsvariabel

Det här kommandot skapar en $PSSessionOption inställningsvariabel.

$PSSessionOption = New-PSSessionOption -OpenTimeOut 120000

När den $PSSessionOption inställningsvariabeln inträffar i sessionen upprättas standardvärden för alternativ i de sessioner som skapas med hjälp av cmdletarna New-PSSession, Enter-PSSessionoch Invoke-Command.

Om du vill göra variabeln $PSSessionOption tillgänglig i alla sessioner lägger du till den i PowerShell-sessionen och i din PowerShell-profil.

Mer information om $PSSessionOption-inställningsvariabeln finns i about_Preference_Variables. Mer information om profiler finns i about_Profiles.

Exempel 6: Uppfylla kraven för en fjärrsessionskonfiguration

Det här exemplet visar hur du använder ett SessionOption--objekt för att uppfylla kraven för en fjärrsessionskonfiguration.

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

Det första kommandot använder cmdleten New-PSSessionOption för att skapa ett sessionsalternativobjekt som har egenskapen SkipCNCheck. Kommandot sparar det resulterande sessionsobjektet i variabeln $skipCN.

Det andra kommandot använder cmdleten New-PSSession för att skapa en ny session på en fjärrdator. Variabeln $skipCN check används i värdet för parametern SessionOption.

Eftersom datorn identifieras av dess IP-adress matchar inte värdet för parametern ComputerName något av de vanliga namnen i certifikatet som används för Secure Sockets Layer (SSL). Därför krävs alternativet SkipCNCheck.

Exempel 7: Gör argument tillgängliga för en fjärrsession

Det här exemplet visar hur du använder parametern ApplicationArguments i cmdleten New-PSSessionOption för att göra ytterligare data tillgängliga för fjärrsessionen.

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

Det första kommandot skapar en hash-tabell med två nycklar, Team och Use. Kommandot sparar hash-tabellen i variabeln $team. Mer information om hash-tabeller finns i about_Hash_Tables.

Sedan skapar New-PSSessionOption-cmdleten med parametern ApplicationArguments ett sessionsalternativobjekt som sparats i variabeln $team. När New-PSSessionOption skapar sessionsalternativobjektet konverteras hash-tabellen automatiskt i värdet för parametern ApplicationArguments till en primitiv ordlista så att data kan överföras på ett tillförlitligt sätt till fjärrsessionen.

Cmdleten New-PSSession startar en session på Server01-datorn. Den använder parametern SessionOption för att inkludera alternativen i variabeln $teamOption.

Cmdleten Invoke-Command visar att data i $team variabeln är tillgängliga för kommandon i fjärrsessionen. Data visas i egenskapen ApplicationArguments för den $PSSenderInfo automatiska variabeln.

Den sista Invoke-Command visar hur data kan användas.

Parametrar

-ApplicationArguments

-CancelTimeout

-Culture

-IdleTimeout

-IncludePortInSPN

-MaxConnectionRetryCount

-MaximumReceivedDataSizePerCommand

-MaximumReceivedObjectSize

-MaximumRedirection

-NoCompression

-NoEncryption

-NoMachineProfile

-OpenTimeout

-OperationTimeout

-OutputBufferingMode

-ProxyAccessType

-ProxyAuthentication

-ProxyCredential

-SkipCACheck

-SkipCNCheck

-SkipRevocationCheck

-UICulture

-UseUTF16

Indata

None

Du kan inte skicka indata till den här cmdleten.

Utdata

PSSessionOption

Kommentarer

Om parametern SessionOption inte används i ett kommando för att skapa en PSSession-, bestäms sessionsalternativen av egenskapsvärdena för $PSSessionOption inställningsvariabel, om den har angetts. Mer information om variabeln $PSSessionOption finns i about_Preference_Variables.

Egenskaperna för ett sessionskonfigurationsobjekt varierar med de alternativ som angetts för sessionskonfigurationen och värdena för dessa alternativ. Sessionskonfigurationer som använder en sessionskonfigurationsfil har dessutom ytterligare egenskaper.

Relaterade länkar

• Enter-PSSession
• Invoke-Command
• New-PSSession