Megosztás a következőn keresztül:

New-WSManSessionOption

Modul:
Microsoft.WSMan.Management Module

Létrehoz egy munkamenet-beállítás kivonattáblát, amely WS-Management parancsmagok bemeneti paramétereként használható.

Syntax

Default (Alapértelmezett) 

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-kivonatoló tá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 a New-WSManSessionOptionáltal meghatározott kapcsolati beállítások használatával hoz létre kapcsolatot a távoli kiszolgáló01 számítógéppel.

Az első parancs New-WSManSessionOption használ a kapcsolatbeállítási beállítások készletének tárolására 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 $a változóban tárolt hitelesítő adatokat a Connect-WSMan. Ezután Connect-WSMan 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 a 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.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-OperationTimeout

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

Paramétertulajdonságok

Típus:Int32
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:OperationTimeoutMSec

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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.

Paramétertulajdonságok

Típus:ProxyAccessType
Alapértelmezett érték:None
Elfogadott értékek:ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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 egy olyan séma, amelyben a rendszer a felhasználónevet és a jelszót világos szövegben küldi el a kiszolgálónak vagy a proxynak.
  • Digest – A kivonatolás 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.

Paramétertulajdonságok

Típus:ProxyAuthentication
Alapértelmezett érték:None
Elfogadott értékek:Negotiate, Basic, Digest
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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.

Paramétertulajdonságok

Típus:PSCredential
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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ó.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-SkipRevocationCheck

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

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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.

Paramétertulajdonságok

Típus:Int32
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Kimenetek

SessionOption

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