New-PSSessionOption

Sözdizimi

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

Cmdlet, New-PSSessionOption kullanıcı tarafından yönetilen oturum (PSSession) için gelişmiş seçenekler içeren bir nesne oluşturur. nesnesini, , Enter-PSSessionve Invoke-Commandgibi bir PSSession oluşturan cmdlet'lerin SessionOption parametresinin değeri olarak New-PSSessionkullanabilirsiniz.

Parametreler olmadan, New-PSSessionOption tüm seçenekler için varsayılan değerleri içeren bir nesne oluşturur. Her özellik düzenlenebildiği için, sonuçta elde edilen nesneyi şablon olarak kullanabilir ve kuruluşunuz için standart seçenek nesneleri oluşturabilirsiniz.

SessionOption nesnesini tercih değişkenine $PSSessionOption de kaydedebilirsiniz. Bu değişkenin değerleri, oturum seçenekleri için yeni varsayılan değerler oluşturur. Oturum için hiçbir oturum seçeneği ayarlanmadığında ve oturum yapılandırmasında ayarlanan seçeneklerden öncelikli olduklarında etkili olurlar, ancak oturumu oluşturan bir cmdlet'te oturum seçeneklerini veya SessionOption nesnesini belirterek bunları geçersiz kılabilirsiniz. Tercih değişkeni hakkında $PSSessionOption daha fazla bilgi için bkz . about_Preference_Variables.

Oturum oluşturan bir cmdlet'te SessionOption nesnesi kullandığınızda, oturum seçeneği değerleri tercih değişkeninde ve oturum yapılandırmasında $PSSessionOption ayarlanan oturumlar için varsayılan değerlerden önceliklidir. Ancak, oturum yapılandırmasında ayarlanan maksimum değer, kota veya sınırlardan öncelikli değildir. Oturum yapılandırmaları hakkında daha fazla bilgi edinmek için bkz. about_Session_Configurations.

Örnekler

Örnek 1: Varsayılan oturum seçeneği oluşturma

Bu komut, varsayılan değerlerle bir SessionOption nesnesi oluşturur.

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

Örnek 2: Oturum seçeneği nesnesi kullanarak oturumu yapılandırma

Bu örnekte, oturumu yapılandırmak için SessionOption nesnesinin nasıl kullanılacağı gösterilmektedir.

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

İlk komut yeni bir SessionOption nesnesi oluşturur ve değişkeninin $pso değerine kaydeder. İkinci komut, Server01 uzak bilgisayarında oturum oluşturmak için cmdlet'ini kullanır New-PSSession . komutu, değişkeninin değerindeki $pso SessionOption nesnesini komutun SessionOption parametresinin değeri olarak kullanır.

Örnek 3: Etkileşimli oturum başlatma

Bu komut, Server01 bilgisayarıyla etkileşimli bir oturum başlatmak için cmdlet'ini kullanır Enter-PSSession .

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

SessionOption parametresinin değeri, NoEncryption ve NoCompression parametrelerini içeren bir New-PSSessionOption komutdur.

New-PSSessionOption Komut, komut öncesinde Enter-PSSession çalıştığından emin olmak için parantez içine alınır.

Örnek 4: Oturum seçeneği nesnesini değiştirme

Bu örnek, SessionOption nesnesini değiştirebileceğinizi gösterir. Tüm özelliklerin okuma/yazma değerleri vardır.

$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

Kuruluşunuz için standart bir oturum nesnesi oluşturmak ve ardından belirli kullanımlar için özelleştirilmiş sürümlerini oluşturmak için bu yöntemi kullanın.

Örnek 5: Tercih değişkeni oluşturma

Bu komut bir $PSSessionOption tercih değişkeni oluşturur.

$PSSessionOption = New-PSSessionOption -OpenTimeOut 120000

$PSSessionOption Tercih değişkeni oturumda ayarlandığında, , Enter-PSSessionve Invoke-Command cmdlet'leri ile New-PSSessionoluşturulan oturumlardaki seçenekler için varsayılan değerler oluşturur.

Değişkenin tüm oturumlarda kullanılabilir olmasını sağlamak $PSSessionOption için değişkeni PowerShell oturumunuza ve PowerShell profilinize ekleyin.

Tercih değişkeni hakkında $PSSessionOption daha fazla bilgi için bkz . about_Preference_Variables. Profiller hakkında daha fazla bilgi için bkz . about_Profiles.

Örnek 6: Uzak oturum yapılandırması gereksinimlerini karşılama

Bu örnekte, uzak oturum yapılandırması gereksinimlerini karşılamak için SessionOption nesnesinin nasıl kullanılacağı gösterilmektedir.

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

İlk komut cmdlet'ini New-PSSessionOption kullanarak SkipCNCheck özelliğine sahip bir SessionOption nesnesi oluşturur. komutu, sonuçta elde edilen oturum nesnesini değişkene $skipCN kaydeder.

İkinci komut cmdlet'ini New-PSSession kullanarak uzak bilgisayarda yeni bir oturum oluşturur. $skipCN Check değişkeni SessionOption parametresinin değerinde kullanılır.

Bilgisayar IP adresiyle tanımlandığından, ComputerName parametresinin değeri Güvenli Yuva Katmanı (SSL) için kullanılan sertifikadaki ortak adlardan herhangi biriyle eşleşmiyor. Sonuç olarak SkipCNCheck seçeneği gereklidir.

Örnek 7: Bağımsız değişkenleri uzak oturumda kullanılabilir hale getirme

Bu örnekte, uzak oturumda ek verileri kullanılabilir hale getirmek için cmdlet'in New-PSSessionOption ApplicationArguments parametresinin nasıl kullanılacağı gösterilmektedir.

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

İlk komut, Team ve Use adlı iki anahtara sahip bir karma tablo oluşturur. komutu karma tablosunu değişkene $team kaydeder. Karma tabloları hakkında daha fazla bilgi için bkz. about_Hash_Tables.

Ardından ApplicationArguments New-PSSessionOption parametresini kullanan cmdlet, değişkene $team kaydedilmiş bir SessionOption nesnesi oluşturur. New-PSSessionOption Oturum seçeneği nesnesini oluşturduğunda, verilerin uzak oturuma güvenilir bir şekilde iletilmesi için ApplicationArguments parametresinin değerindeki karma tabloyu otomatik olarak PrimitiveDictionary'e dönüştürür.

Cmdlet, New-PSSession Server01 bilgisayarında bir oturum başlatır. Değişkene seçenekleri eklemek için SessionOption parametresini $teamOption kullanır.

cmdlet'i Invoke-Command , değişkendeki $team verilerin uzak oturumdaki komutlar için kullanılabilir olduğunu gösterir. Veriler, otomatik değişkenin ApplicationArguments özelliğinde $PSSenderInfo görünür.

Son olarak Invoke-Command verilerin nasıl kullanılabileceğini görebilirsiniz.

Parametreler

-ApplicationArguments

-CancelTimeout

-Culture

-IdleTimeout

-IncludePortInSPN

-MaxConnectionRetryCount

-MaximumReceivedDataSizePerCommand

-MaximumReceivedObjectSize

-MaximumRedirection

-NoCompression

-NoEncryption

-NoMachineProfile

-OpenTimeout

-OperationTimeout

-OutputBufferingMode

-ProxyAccessType

-ProxyAuthentication

-ProxyCredential

-SkipCACheck

-SkipCNCheck

-SkipRevocationCheck

-UICulture

-UseUTF16

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

PSSessionOption

Notlar

SessionOption parametresi pssession oluşturmak için bir komutta kullanılmazsa, oturum seçenekleri ayarlıysa tercih değişkeninin $PSSessionOption özellik değerlerine göre belirlenir. Değişken hakkında $PSSessionOption daha fazla bilgi için bkz . about_Preference_Variables.

Oturum yapılandırma nesnesinin özellikleri, oturum yapılandırması için ayarlanan seçeneklere ve bu seçeneklerin değerlerine göre değişir. Ayrıca, oturum yapılandırma dosyası kullanan oturum yapılandırmaları ek özelliklere sahiptir.

İlişkili Bağlantılar

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