New-PSSessionOption

Modül:: Microsoft.PowerShell.Core Module

PSSession için gelişmiş seçenekler içeren bir nesne oluşturur.

Syntax

Default (Varsayılan)

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

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

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.

tercih değişkenine $PSSessionOption nesnesini 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 etkilidirler, ancak oturum seçeneklerini veya oturum oluşturan bir cmdlet'teki SessionOption nesnesini belirterek bunları geçersiz kılabilirsiniz. $PSSessionOption tercih değişkeni hakkında 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 $PSSessionOption tercih değişkeninde ve oturum yapılandırmasında 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 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 $pso değişkeninin değerine kaydeder. İkinci komut, Server01 uzak bilgisayarında oturum oluşturmak için New-PSSession cmdlet'ini kullanır. komut, değişkeninin değerindeki $pso 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 Enter-PSSession cmdlet'ini kullanır.

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

SessionOption parametresinin değeri, New-PSSessionOption ve NoCompression parametrelerine sahip bir komutudur.

New-PSSessionOption komutu, Enter-PSSession komutundan önce ç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

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

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

$PSSessionOption tercih değişkeni hakkında 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, New-PSSessionOption özelliğine sahip bir SessionOption nesnesi oluşturmak için cmdlet'ini kullanır. komutu, sonuçta elde edilen oturum nesnesini $skipCN değişkenine kaydeder.

İkinci komut, uzak bilgisayarda yeni bir oturum oluşturmak için New-PSSession cmdlet'ini kullanır. $skipCN denetim 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, cmdlet'inin New-PSSessionOption parametresini kullanarak uzak oturumda ek verilerin nasıl kullanılabilir hale getirilebilir olduğu 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 Useanahtarlarıyla iki anahtarlı bir karma tablo (hash table) oluşturur. komutu karma tablosunu $team değişkenine kaydeder. Karma tabloları hakkında daha fazla bilgi için bkz. about_Hash_Tables.

Ardından New-PSSessionOption parametresini kullanan cmdlet'i, değişkenine kaydedilmiş bir $team nesnesi oluşturur. New-PSSessionOption oturum seçeneği nesnesini oluşturduğunda, ApplicationArguments parametresinin değerindeki karma tabloyu otomatik olarak PrimitiveDictionary dönüştürerek verilerin uzak oturuma güvenilir bir şekilde iletilmesini sağlar.

New-PSSession cmdlet'i, Server01 bilgisayarında bir oturum başlatır. değişkenine seçenekleri eklemek için $teamOption parametresini kullanır.

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

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

Parametreler

-ApplicationArguments

Uzak oturuma gönderilen bir PrimitiveDictionary belirtir. Oturum yapılandırmasındaki başlangıç betikleri de dahil olmak üzere uzak oturumdaki komutlar ve betikler, bu sözlüğü otomatik değişkeninin applicationarguments $PSSenderInfo özelliğinde bulabilir. Uzak oturuma veri göndermek için bu parametreyi kullanabilirsiniz.

Önemli

Bu özellik istemci tarafından açıkça sağlanan verileri içerdiğinden, güvenlik kararları için bunu kullanmak saldırganların yetkilendirme denetimlerini atlamasına izin verebilir. Bu verileri asla güven kararları için kullanmayın. Diğer uygulama mantığı için kullanıldığında tüm kullanıcı girişlerini doğrulayın.

Daha fazla bilgi için bkz. about_Hash_Tables, about_Session_Configurationsve about_Automatic_Variables.

Parametre özellikleri

Tür:	PSPrimitiveDictionary
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-CancelTimeout

PowerShell'in iptal işlemini (CTRL+C) sonlandırmadan önce ne kadar süreyle tamamlanmasını bekleyeceğini belirler. Milisaniye cinsinden bir değer girin.

Varsayılan değer 60000 (bir dakika) olur. 0 (sıfır) değeri zaman aşımı olmadığı anlamına gelir; komutu süresiz olarak devam eder.

Parametre özellikleri

Tür:	Int32
Default value:	60000
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	CancelTimeoutMSec

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Culture

Oturum için kullanılacak kültürü belirtir. <languagecode2>-<country/regioncode2> biçiminde bir kültür adı (ja-JPgibi), CultureInfo nesnesi içeren bir değişken veya CultureInfo nesnesi alan bir komut girin.

Varsayılan değer $nullve işletim sisteminde ayarlanan kültür oturumda kullanılır.

Parametre özellikleri

Tür:	CultureInfo
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-IdleTimeout

Uzak bilgisayar yerel bilgisayardan herhangi bir iletişim almazsa oturumun ne kadar süreyle açık kalacağını belirler. Bu, kalp atış sinyalini içerir. Aralığın süresi dolduğunda oturum kapanır.

Oturumun bağlantısını kesip yeniden bağlamak istiyorsanız boşta kalma zaman aşımı değeri önemli bir öneme sahip olur. Yalnızca oturum zaman aşımına uğramadıysa yeniden bağlanabilirsiniz.

Milisaniye cinsinden bir değer girin. Minimum değer 60000 (1 dakika) olarak belirtilmiştir. Maksimum değer, oturum yapılandırmasının MaxIdleTimeoutMs özelliğinin değeridir. varsayılan değer olan -1boşta kalma zaman aşımı ayarlamaz.

Oturum, varsa oturum seçeneklerinde ayarlanan boşta kalma zaman aşımını kullanır. Hiçbiri ayarlı değilse (-1), oturum, oturum yapılandırmasının IdleTimeoutMs özelliğinin değerini veya WSMan kabuk zaman aşımı değerini (WSMan:\<ComputerName>\Shell\IdleTimeout) (hangisi en kısaysa) kullanır.

Oturum seçeneklerinde ayarlanan boşta kalma zaman aşımı, oturum yapılandırmasının MaxIdleTimeoutMs özelliğinin değerini aşarsa, oturum oluşturma komutu başarısız olur.

IdleTimeoutMs varsayılan Microsoft.PowerShell oturum yapılandırmasının değeri 7200000 milisaniyedir (2 saat). MaxIdleTimeoutMs değeri 2147483647 milisaniye (>24 gün). WSMan kabuğu boşta kalma zaman aşımı (WSMan:\<ComputerName>\Shell\IdleTimeout) varsayılan değeri 7200000 milisaniyedir (2 saat).

Oturumun boşta kalma zaman aşımı değeri, oturum bağlantısını keserken veya oturuma yeniden bağlanırken de değiştirilebilir. Daha fazla bilgi için bkz. Disconnect-PSSession ve Connect-PSSession.

Windows PowerShell 2.0'da, IdleTimeout parametresinin varsayılan değeri 240000 (4 dakika).

Parametre özellikleri

Tür:	Int32
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	IdleTimeoutMSec

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-IncludePortInSPN

Kerberos kimlik doğrulaması için kullanılan Hizmet Asıl Adı'na (SPN) bağlantı noktası numarasını (örneğin, HTTP://<ComputerName>:5985) ekler. Bu seçenek, Kerberos kimlik doğrulaması kullanan uzak bir bilgisayarda kimlik doğrulaması yapmak için varsayılan olmayan spn kullanan bir istemciye izin verir.

seçeneği, Kerberos kimlik doğrulamasını destekleyen birden çok hizmetin farklı kullanıcı hesapları altında çalıştığı kuruluşlar için tasarlanmıştır. Örneğin, Kerberos kimlik doğrulamasına izin veren bir IIS uygulaması, varsayılan SPN'nin bilgisayar hesabından farklı bir kullanıcı hesabına kaydedilmesini gerektirebilir. Böyle durumlarda PowerShell uzaktan iletişim, bilgisayar hesabına kayıtlı bir SPN gerektirdiğinden kimlik doğrulaması için Kerberos kullanamaz. Yöneticiler bu sorunu çözmek için farklı kullanıcı hesaplarına kayıtlı olan ve bağlantı noktası numarasını SPN'ye ekleyerek aralarında ayrım yapabilen Setspn.exekullanarak farklı SPN'ler oluşturabilir.

Daha fazla bilgi için bkz. Setspn'ye Genel Bakış.

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-MaxConnectionRetryCount

Ağ sorunları nedeniyle geçerli deneme başarısız olursa PowerShell'in hedef makineyle bağlantı kurmaya çalışma sayısını belirtir. Varsayılan değer şudur: 5.

Bu parametre PowerShell sürüm 5.0 için eklendi.

Parametre özellikleri

Tür:	Int32
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-MaximumReceivedDataSizePerCommand

Yerel bilgisayarın tek bir komutta uzak bilgisayardan alabileceği bayt sayısı üst sınırını belirtir. Bayt cinsinden bir değer girin. Varsayılan olarak veri boyutu sınırı yoktur.

Bu seçenek, istemci bilgisayardaki kaynakları korumak için tasarlanmıştır.

Parametre özellikleri

Tür:	Int32
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-MaximumReceivedObjectSize

Yerel bilgisayarın uzak bilgisayardan alabileceği en büyük nesne boyutunu belirtir. Bu seçenek, istemci bilgisayardaki kaynakları korumak için tasarlanmıştır. Bayt cinsinden bir değer girin.

Windows PowerShell 2.0'da bu parametreyi atlarsanız nesne boyutu sınırı yoktur. Windows PowerShell 3.0'da başlayarak, bu parametreyi atlarsanız varsayılan değer 209715200 bayttır (veya 200MB).

Parametre özellikleri

Tür:	Int32
Default value:	209715200
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-MaximumRedirection

Bağlantı başarısız olmadan önce PowerShell'in bir bağlantıyı kaç kez alternatif bir Tekdüzen Kaynak Tanımlayıcısı'na (URI) yönlendirdiğini belirler. Varsayılan değer şudur: 5. 0 (sıfır) değeri tüm yeniden yönlendirmeyi engeller.

Bu seçenek, oturumu oluşturan komutta AllowRedirection parametresi kullanıldığında yalnızca oturumda kullanılır.

Parametre özellikleri

Tür:	Int32
Default value:	5
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-NoCompression

Oturumda paket sıkıştırmayı kapatır. Sıkıştırma daha fazla işlemci döngüsü kullanır, ancak iletimi hızlandırır.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-NoEncryption

Veri şifrelemeyi kapatır.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-NoMachineProfile

Kullanıcının Windows kullanıcı profilinin yüklenmesini engeller. Sonuç olarak, oturum daha hızlı oluşturulabilir, ancak kullanıcıya özgü kayıt defteri ayarları, ortam değişkenleri ve sertifikalar gibi öğeler oturumda kullanılamaz.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-OpenTimeout

İstemci bilgisayarın oturum bağlantısının kurulmasını ne kadar süre bekleyeceğini belirler. Aralığın süresi dolduğunda, bağlantı kurma komutu başarısız olur. Milisaniye cinsinden bir değer girin.

Varsayılan değer 180000 (3 dakika). 0 (sıfır) değeri zaman aşımı olmadığı anlamına gelir; komutu süresiz olarak devam eder.

Parametre özellikleri

Tür:	Int32
Default value:	180000 (3 minutes)
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	OpenTimeoutMSec

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-OperationTimeout

WinRM maksimum süreyi belirler bağlantı zaman aşımı başlatmadan önce canlı bağlantıdan pozitif bağlantı testlerini bekler. WinRM hakkında daha fazla bilgi için Windows Uzaktan Yönetim Belgeleribölümüne bakın.

OperationTimeout uzak oturumda çalışan komutlara veya işlemlere zaman sınırı ve SSH gibi diğer uzaktan iletişim protokollerini etkilemez.

Varsayılan değer 180000 (3 dakika). 0 (sıfır) değeri zaman aşımı olmadığı anlamına gelir.

Parametre özellikleri

Tür:	Int32
Default value:	180000 (3 minutes)
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	OperationTimeoutMSec

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-OutputBufferingMode

Çıkış arabelleği dolduğunda, komut çıkışının bağlantısız oturumlarda nasıl yönetileceğini belirler.

Çıkış arabelleğe alma modu oturumda veya oturum yapılandırmasında ayarlanmadıysa, varsayılan değer Blockolur. Kullanıcılar oturumun bağlantısını keserken çıkış arabelleği modunu da değiştirebilir.

Bu parametreyi atlarsanız, SessionOption nesnesinin OutputBufferingMode değeri None. Block veya Drop değeri, oturum yapılandırmasında ayarlanan çıkış arabelleği modu taşıma seçeneğini geçersiz kılar. Bu parametre için kabul edilebilir değerler şunlardır:

Block. Çıkış arabelleği dolduğunda, arabellek temizlenene kadar yürütme askıya alınır.
Drop. Çıkış arabelleği dolduğunda yürütme devam eder. Yeni çıkış kaydedildikçe en eski çıkış silinir.
None. Çıkış arabelleği modu belirtilmedi.

Çıkış arabelleğe alma modu taşıma seçeneği hakkında daha fazla bilgi için bkz. New-PSTransportOption.

Bu parametre Windows PowerShell 3.0'da kullanıma sunulmuştur.

Parametre özellikleri

Tür:	OutputBufferingMode
Default value:	None
Kabul edilen değerler:	None, Drop, Block
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ProxyAccessType

Konak adını çözümlemek için hangi mekanizmanın kullanılacağını belirler. Bu parametre için kabul edilebilir değerler şunlardır:

IEConfig
WinHttpConfig
AutoDetect
NoProxyServer
None

Varsayılan değer şudur: None.

Bu parametrenin değerleri hakkında bilgi için bkz. ProxyAccessType Sabit Listesi.

Parametre özellikleri

Tür:	ProxyAccessType
Default value:	None
Kabul edilen değerler:	None, IEConfig, WinHttpConfig, AutoDetect, NoProxyServer
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ProxyAuthentication

Ara sunucu çözümlemesi için kullanılan kimlik doğrulama yöntemini belirtir. Bu parametre için kabul edilebilir değerler şunlardır:

Basic
Digest
Negotiate

Varsayılan değer şudur: Negotiate.

Bu parametrenin değerleri hakkında daha fazla bilgi için bkz. Kimlik Doğrulama Mekanizması Enumerasyonu.

Parametre özellikleri

Tür:	AuthenticationMechanism
Default value:	Negotiate
Kabul edilen değerler:	Default, Basic, Negotiate, NegotiateWithImplicitCredential, Credssp, Digest, Kerberos
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ProxyCredential

Proxy kimlik doğrulaması için kullanılacak kimlik bilgilerini belirtir. PSCredential nesnesi içeren bir değişken veya komutu gibi, Get-Credential nesnesi alan bir komut girin. Bu seçenek ayarlanmazsa hiçbir kimlik bilgisi belirtilmez.

Parametre özellikleri

Tür:	PSCredential
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-SkipCACheck

HTTPS üzerinden bağlandığında istemcinin sunucu sertifikasının güvenilen bir sertifika yetkilisi (CA) tarafından imzalandığını doğrulamadığını belirtir.

Bu seçeneği yalnızca uzak bilgisayar fiziksel olarak güvenli ve yalıtılmış bir ağın parçası olduğunda veya uzak bilgisayarın WinRM yapılandırmasında güvenilir bir konak olarak listelendiği durumlarda, başka bir mekanizma kullanılarak uzak bilgisayara güvenildiğinde kullanın.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-SkipCNCheck

Sunucunun sertifika ortak adının (CN) sunucunun ana bilgisayar adıyla eşleşmesi gerekmediğini belirtir. Bu seçenek yalnızca HTTPS protokolunu kullanan uzak işlemlerde kullanılır.

Bu seçeneği yalnızca güvenilen bilgisayarlar için kullanın.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-SkipRevocationCheck

Sunucu sertifikasının iptal durumunu doğrulamaz.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-UICulture

Oturum için kullanılacak kullanıcı arabirimi kültürünü belirtir.

Geçerli değerler şunlardır:

<languagecode2>-<country/regioncode2> biçiminde, ja-JP gibi bir kültür adı
CultureInfo nesnesi içeren değişken
gibi bir Get-Culture nesnesi alan komut

Varsayılan değer $nullve oturum oluşturulduğunda işletim sisteminde ayarlanan kullanıcı arabirimi kültürüdür.

Parametre özellikleri

Tür:	CultureInfo
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-UseUTF16

Bu cmdlet'in isteği UTF8 biçimi yerine UTF16 biçiminde kodladığını gösterir.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

PSSessionOption

Notlar

SessionOption parametresi bir komutta PSSessionoluşturmak için kullanılmazsa ve $PSSessionOption tercih değişkeni ayarlanmışsa, oturum seçenekleri bu değişkenin özellik değerlerine göre belirlenir. $PSSessionOption değişkeni hakkında 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.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?