New-WSManSessionOption

  • Referencia
Modul:
Microsoft.WSMan.Management

A WS-Management parancsmagok bemeneti paramétereként használandó munkamenet-beállítás kivonattáblája.

Syntax

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

Description

Ez a parancsmag csak a Windows platformon érhető el.

A New-WSManSessionOption parancsmag létrehoz egy WSMan-munkamenet beállításkivonattáblát, amely átadható a WSMan-parancsmagoknak:

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

Példák

1. példa: Kapcsolati beállításokat használó kapcsolat létrehozása

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

Ez a példa létrehoz egy kapcsolatot a távoli kiszolgáló01 számítógéppel a megadott kapcsolati beállítások New-WSManSessionOptionhasználatával.

Az első parancs a kapcsolatbeállítási beállítások egy készletének tárolására használja New-WSManSessionOption a $a változóban. Ebben az esetben a munkamenet beállításai 30 másodpercből (30 000 ezredmásodpercből) állítják be a csatlakozási időt.

A második parancs a SessionOption paraméter használatával adja át a változóban Connect-WSMantárolt hitelesítő adatokat.$a Connect-WSMan Ezután a megadott munkamenet-beállítások használatával csatlakozik a távoli kiszolgáló01 számítógéphez.

Connect-WSMan általában a WSMan-szolgáltató kontextusában használják távoli számítógéphez való csatlakozáshoz, ebben az esetben a kiszolgáló01 számítógéphez. A parancsmaggal azonban kapcsolatot létesíthet a távoli számítógépekkel, mielőtt átvált a WSMan-szolgáltatóra. Ezek a kapcsolatok megjelennek a ComputerName listában.

Paraméterek

-NoEncryption

Azt jelzi, hogy a kapcsolat nem használ titkosítást a HTTP-en keresztüli távoli műveletekhez.

Alapértelmezés szerint a titkosítatlan forgalom nincs engedélyezve. A helyi konfigurációban engedélyezni kell.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OperationTimeout

Ezredmásodpercben megadja a WS-Management művelet időtúllépését.

Type:Int32
Aliases:OperationTimeoutMSec
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProxyAccessType

Meghatározza azt a mechanizmust, amellyel a proxykiszolgáló található. A paraméter elfogadható értékei a következők:

  • ProxyIEConfig – Használja az Internet Explorer proxykonfigurációját az aktuális felhasználóhoz.
  • ProxyWinHttpConfig - A WSMan-ügyfél a WinHTTP-hoz konfigurált proxybeállításokat használja a ProxyCfg.exe segédprogrammal.
  • ProxyAutoDetect – Proxykiszolgáló automatikus észlelésének kényszerítése.
  • ProxyNoProxyServer - Ne használjon proxykiszolgálót. Az összes gazdagépnév helyi feloldása.

Az alapértelmezett érték a ProxyIEConfig.

Type:ProxyAccessType
Accepted values:ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProxyAuthentication

Megadja a proxyn használni kívánt hitelesítési módszert. A paraméter elfogadható értékei a következők:

  • Basic - Az alapszintű séma a felhasználónév és a jelszó egyszerű szöveges elküldése a kiszolgálónak vagy a proxynak.
  • Digest - A Digest egy kihívás-válasz séma, amely egy kiszolgáló által megadott adatsztringet használ a feladathoz.
  • Negotiate - Az egyeztetés egy kihívás-válasz séma, amely egyeztet a kiszolgálóval vagy a proxyval annak meghatározásához, hogy melyik sémát használja a hitelesítéshez. Ilyen például a Kerberos protokoll és az NTLM.

Az alapértelmezett érték az Egyeztetés.

Type:ProxyAuthentication
Accepted values:Negotiate, Basic, Digest
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProxyCredential

Olyan felhasználói fiókot ad meg, amely engedéllyel rendelkezik a közbenső webes proxyn keresztüli hozzáféréshez.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipCACheck

Megadja, hogy amikor HTTPS-en keresztül csatlakozik, az ügyfél nem ellenőrzi, hogy a kiszolgálói tanúsítványt megbízható hitelesítésszolgáltató (CA) írta-e alá. Ezt a lehetőséget csak akkor használja, ha a távoli számítógépet egy másik módszer megbízhatónak tekinti, például ha a távoli számítógép fizikailag biztonságos és elkülönített hálózat része, vagy a távoli számítógép megbízható gazdagépként szerepel a WS-Management konfigurációban.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipCNCheck

Azt adja meg, hogy a kiszolgáló tanúsítványának köznapi neve (CN) nem feleljen meg a kiszolgáló gazdagépnevének. Ez csak a HTTPS-t használó távoli műveletekhez használható. Ez a beállítás csak megbízható számítógépekhez használható.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipRevocationCheck

Azt jelzi, hogy a kapcsolat nem ellenőrzi a visszavonás állapotát a kiszolgálótanúsítványon.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SPNPort

Megadja a távoli kiszolgáló kapcsolati szolgáltatásnévéhez (SPN) hozzáfűzendő portszámot. A rendszer spn-et használ, ha a hitelesítési mechanizmus Kerberos vagy Egyeztetés.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseUTF16

Azt jelzi, hogy a kapcsolat UTF8 formátum helyett UTF16 formátumban kódolja a kérést. Az alapértelmezett UTF8 kódolás.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Kimenetek

SessionOption

Ez a parancsmag a létrehozott WSMan munkamenet-beállítást adja vissza SessionOption objektumként.