Aracılığıyla paylaş

New-WSManSessionOption

  • Başvuru
Modül:
Microsoft.WSMan.Management

WS-Management cmdlet'leri için giriş parametreleri olarak kullanılacak oturum seçeneği karma tablosu oluşturur.

Sözdizimi

New-WSManSessionOption
   [-ProxyAccessType <ProxyAccessType>]
   [-ProxyAuthentication <ProxyAuthentication>]
   [-ProxyCredential <PSCredential>]
   [-SkipCACheck]
   [-SkipCNCheck]
   [-SkipRevocationCheck]
   [-SPNPort <Int32>]
   [-OperationTimeout <Int32>]
   [-NoEncryption]
   [-UseUTF16]
   [<CommonParameters>]

Description

Bu cmdlet yalnızca Windows platformunda kullanılabilir.

cmdlet'i New-WSManSessionOption , WSMan cmdlet'lerine geçirilebilen bir WSMan Oturumu seçeneği karma tablosu oluşturur:

  • Get-WSManInstance
  • Set-WSManInstance
  • Invoke-WSManAction
  • Connect-WSMan

Örnekler

Örnek 1: Bağlantı seçeneklerini kullanan bir bağlantı oluşturma

PS C:\> $a = New-WSManSessionOption -OperationTimeout 30000
PS C:\> Connect-WSMan -ComputerName "server01" -SessionOption $a
PS C:\> cd wsman:
PS WSMan:\> dir

WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan
ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

Bu örnek, tarafından New-WSManSessionOptiontanımlanan bağlantı seçeneklerini kullanarak uzak sunucu01 bilgisayara bir bağlantı oluşturur.

İlk komut, değişkende bir dizi bağlantı ayarı seçeneğini depolamak $a için kullanırNew-WSManSessionOption. Bu durumda oturum seçenekleri 30 saniyelik (30.000 milisaniye) bir bağlantı süresi ayarlar.

İkinci komut, değişkeninde depolanan kimlik bilgilerini öğesine geçirmek için SessionOption parametresini $a Connect-WSMankullanır. Ardından, Connect-WSMan belirtilen oturum seçeneklerini kullanarak uzak sunucu01 bilgisayara bağlanır.

Connect-WSMan genellikle uzak bir bilgisayara bağlanmak için WSMan sağlayıcısı bağlamında kullanılır, bu durumda sunucu01 bilgisayarı. Ancak, WSMan sağlayıcısına geçmeden önce uzak bilgisayarlara bağlantı kurmak için cmdlet'ini kullanabilirsiniz. Bu bağlantılar ComputerName listesinde görünür.

Parametreler

-NoEncryption

Bağlantının HTTP üzerinden uzak işlemler için şifreleme kullanmadığını gösterir.

Varsayılan olarak, şifrelenmemiş trafik etkin değildir. Yerel yapılandırmada etkinleştirilmelidir.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-OperationTimeout

WS-Management işlemi için milisaniye cinsinden zaman aşımını belirtir.

Tür:Int32
Diğer adlar:OperationTimeoutMSec
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ProxyAccessType

Ara sunucunun bulunduğu mekanizmayı belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:

  • ProxyIEConfig - Geçerli kullanıcı için Internet Explorer proxy yapılandırmasını kullanın.
  • ProxyWinHttpConfig - WSMan istemcisi, ProxyCfg.exe yardımcı programını kullanarak WinHTTP için yapılandırılan proxy ayarlarını kullanır.
  • ProxyAutoDetect - Ara sunucunun otomatik algısını zorlama.
  • ProxyNoProxyServer - Ara sunucu kullanmayın. Tüm konak adlarını yerel olarak çözümle.

Varsayılan değer ProxyIEConfig'dir.

Tür:ProxyAccessType
Kabul edilen değerler:ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ProxyAuthentication

Proxy'de kullanılacak kimlik doğrulama yöntemini belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:

  • Basic - Temel, kullanıcı adı ve parolanın sunucuya veya ara sunucuya düz metin olarak gönderildiği bir düzendir.
  • Digest - Özet, sınama için sunucu tarafından belirtilen bir veri dizesi kullanan bir sınama yanıtı düzenidir.
  • Negotiate - Anlaşma, kimlik doğrulaması için hangi düzenin kullanılacağını belirlemek üzere sunucu veya ara sunucuyla anlaşma yapan bir sınama yanıtı düzenidir. Örnek olarak Kerberos protokolü ve NTLM verilebilir.

Varsayılan değer Anlaşma'dır.

Tür:ProxyAuthentication
Kabul edilen değerler:Negotiate, Basic, Digest
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ProxyCredential

Ara Web ara sunucusu üzerinden erişim izni olan bir kullanıcı hesabı belirtir.

Tür:PSCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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 bilgisayara başka bir yöntem tarafından güvenildiğinde( örneğin, uzak bilgisayar fiziksel olarak güvenli ve yalıtılmış bir ağın parçasıysa veya uzak bilgisayar WS-Management yapılandırmasında güvenilir bir konak olarak listeleniyorsa) kullanın.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-SkipCNCheck

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

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-SkipRevocationCheck

Bağlantının sunucu sertifikasındaki iptal durumunu doğrulamadığını gösterir.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-SPNPort

Uzak sunucunun bağlantı Hizmet Asıl Adı'na (SPN) eklenecek bağlantı noktası numarasını belirtir. Kimlik doğrulama mekanizması Kerberos veya Anlaşma olduğunda SPN kullanılır.

Tür:Int32
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-UseUTF16

Bağlantının isteği UTF8 biçimi yerine UTF16 biçiminde kodladığını gösterir. Varsayılan değer UTF8 kodlamadır.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Çıkışlar

SessionOption

Bu cmdlet, oluşturulan WSMan oturum seçeneğini SessionOption nesnesi olarak döndürür.