Invoke-WebRequest
Lekéri a tartalmat egy internetes weblapról.
Syntax
Default (Alapértelmezett)
Invoke-WebRequest
[-UseBasicParsing]
[-Uri] <Uri>
[-WebSession <WebRequestSession>]
[-SessionVariable <String>]
[-Credential <PSCredential>]
[-UseDefaultCredentials]
[-CertificateThumbprint <String>]
[-Certificate <X509Certificate>]
[-UserAgent <String>]
[-DisableKeepAlive]
[-TimeoutSec <Int32>]
[-Headers <IDictionary>]
[-MaximumRedirection <Int32>]
[-Method <WebRequestMethod>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-ProxyUseDefaultCredentials]
[-Body <Object>]
[-ContentType <String>]
[-TransferEncoding <String>]
[-InFile <String>]
[-OutFile <String>]
[-PassThru]
[<CommonParameters>]
Description
A Invoke-WebRequest parancsmag HTTP-, HTTPS-, FTP- és FILE-kéréseket küld egy weblapnak vagy webszolgáltatásnak.
Elemzi a választ, és űrlapok, hivatkozások, képek és egyéb jelentős HTML-elemek gyűjteményeit adja vissza.
Ezt a parancsmagot a Windows PowerShell 3.0-ban vezettük be.
Megjegyzés:
Alapértelmezés szerint a weblap szkriptkódja futtatható, ha a lap elemzése folyamatban van a ParsedHtml tulajdonság feltöltéséhez.
Ezt a -UseBasicParsing kapcsolóval tilthatja le.
Példák
1. példa: Webes kérés küldése
Ez a parancs a Invoke-WebRequest parancsmaggal küld webkérelmet a Bing.com webhelyre.
$R = Invoke-WebRequest -URI https://www.bing.com?q=how+many+feet+in+a+mile
$R.AllElements | Where-Object {
$_.name -like "* Value" -and $_.tagName -eq "INPUT"
} | Select-Object Name, Value
name value
---- -----
From Value 1
To Value 5280
Az első parancs kiadja a kérést, és menti a választ a $R változóba.
A második parancs szűri az AllElements tulajdonság objektumait, ahol a név tulajdonság a "* Érték" tulajdonsághoz hasonló, a tagName pedig "INPUT". A szűrt eredményeket a rendszer a Select-Object gombra állítva választja ki a nevet és értéket tulajdonságokat.
2. példa: Állapotalapú webszolgáltatás használata
Ez a példa bemutatja, hogyan használhatja a Invoke-WebRequest parancsmagot egy állapotalapú webszolgáltatással, például a Facebookkal.
$R = Invoke-WebRequest https://www.facebook.com/login.php -SessionVariable fb
# This command stores the first form in the Forms property of the $R variable in the $Form variable.
$Form = $R.Forms[0]
# This command shows the fields available in the Form.
$Form.fields
Key Value
--- -----
...
email
pass
...
# These commands populate the username and password of the respective Form fields.
$Form.Fields["email"]="User01@Fabrikam.com"
$Form.Fields["pass"]="P@ssw0rd"
# This command creates the Uri that will be used to log in to facebook.
# The value of the Uri parameter is the value of the Action property of the form.
$Uri = "https://www.facebook.com" + $Form.Action
# Now the Invoke-WebRequest cmdlet is used to sign into the Facebook web service.
# The WebRequestSession object in the $FB variable is passed as the value of the WebSession parameter.
# The value of the Body parameter is the hash table in the Fields property of the form.
# The value of the *Method* parameter is POST. The command saves the output in the $R variable.
$R = Invoke-WebRequest -Uri $Uri -WebSession $FB -Method POST -Body $Form.Fields
$R.StatusDescription
Az első parancs a Invoke-WebRequest parancsmaggal küldi el a bejelentkezési kérést. A parancs az SessionVariable paraméter értékének "FB" értékét adja meg, és menti az eredményt a $R változóban. A parancs befejeződésekor a $R változó egy HtmlWebResponseObject tartalmaz, a $FB változó pedig egy WebRequestSession objektumot tartalmaz.
Miután a Invoke-WebRequest parancsmag bejelentkezett a Facebookra, a változó webes válaszobjektumának $R tulajdonsága azt jelzi, hogy a felhasználó sikeresen bejelentkezett.
3. példa: Hivatkozások lekérése weblapról
Ez a parancs lekéri a hivatkozásokat egy weblapon.
(Invoke-WebRequest -Uri "https://devblogs.microsoft.com/powershell/").Links.Href
A Invoke-WebRequest parancsmag lekéri a weblap tartalmát.
Ezután a visszaadott HtmlWebResponseObjectHivatkozások tulajdonsága az egyes hivatkozások Href tulajdonságának megjelenítésére szolgál.
4. példa: Nem sikeres üzenetek elfogása Invoke-WebRequest
Ha Invoke-WebRequest nem sikeres HTTP-üzenettel (404, 500 stb.) találkozik, akkor nem ad vissza kimenetet, és leállási hibát jelez. A hiba elhárításához és a StatusCode megtekintéséhez a végrehajtást egy try/catch blokkba zárhatja. Az alábbi példa bemutatja, hogyan lehet ezt végrehajtani.
try
{
$response = Invoke-WebRequest -Uri "www.microsoft.com/unkownhost" -ErrorAction Stop
# This will only execute if the Invoke-WebRequest is successful.
$StatusCode = $Response.StatusCode
}
catch
{
$StatusCode = $_.Exception.Response.StatusCode.value__
}
$StatusCode
404
Az első parancs catch blokk észleli, amely lekéri a StatusCode a Exception objektumból.
Paraméterek
-Body
A kérelem törzsét adja meg.
A törzs a fejléceket követő kérés tartalma.
A törzsértéket a Invoke-WebRequestrészére is át lehet irányítani.
A törzs paraméterrel megadhatja a lekérdezési paraméterek listáját, vagy megadhatja a válasz tartalmát.
Ha a bemenet egy GET kérés, és a törzs egy IDictionary (ami általában egy kivonattáblázat), a törzs az URI-hoz lekérdezési paraméterekként kerül hozzáadásra. Más GET-kérések esetén a törzs a kérés törzsének értékeként van beállítva standard name=value formátumban.
Ha a törzs egy űrlap, vagy egy Invoke-WebRequest hívás kimenete, a PowerShell a kérelem tartalmát az űrlapmezőkre állítja.
Például:
$r = Invoke-WebRequest https://website.com/login.aspx
$r.Forms\[0\].Name = "MyName"
$r.Forms\[0\].Password = "MyPassword"
Invoke-RestMethod https://website.com/service.aspx -Body $r
- vagy-
Invoke-RestMethod https://website.com/service.aspx -Body $r.Forms\[0\]
Paramétertulajdonságok
| Típus: | Object |
| 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: | True |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Certificate
Megadja a biztonságos webkérelemhez használt ügyféltanúsítványt. Adjon meg egy változót, amely tartalmaz egy tanúsítványt, vagy egy parancsot vagy kifejezést, amely lekéri a tanúsítványt.
Tanúsítvány kereséséhez használja Get-PfxCertificate vagy használja a Get-ChildItem parancsmagot a Tanúsítvány (Cert:) meghajtón.
Ha a tanúsítvány érvénytelen, vagy nem rendelkezik megfelelő jogosultságtal, a parancs meghiúsul.
Paramétertulajdonságok
| Típus: | X509Certificate |
| 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 |
-CertificateThumbprint
Egy olyan felhasználói fiók digitális nyilvános kulcsú tanúsítványát (X509) adja meg, amely jogosult a kérés elküldésére. Adja meg a tanúsítvány ujjlenyomatát. A tanúsítványok az ügyféltanúsítvány-alapú hitelesítésben használatosak. Ezek csak helyi felhasználói fiókokra képezhetők le; nem működnek tartományi fiókokkal.
Tanúsítvány ujjlenyomatának lekéréséhez használja a PowerShell-Get-Item meghajtó Get-ChildItem vagy Cert: parancsát.
Paramétertulajdonságok
| Típus: | String |
| 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 |
-ContentType
Megadja a webes kérelem tartalomtípusát.
Ha ez a paraméter nincs megadva, és a kérelem metódusa POST, Invoke-WebRequest a tartalomtípust application/x-www-form-urlencoded értékre állítja. Ellenkező esetben a tartalomtípus nincs megadva a hívásban.
Paramétertulajdonságok
| Típus: | String |
| 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 |
-Credential
Olyan felhasználói fiókot ad meg, amely rendelkezik a kérés elküldéséhez szükséges engedéllyel. Az alapértelmezett az aktuális felhasználó.
Írjon be egy felhasználónevet, például User01 vagy Domain01\User01, vagy írjon be egy PSCredential objektumot, például a Get-Credential parancsmag által létrehozott objektumot.
Paramétertulajdonságok
| Típus: | PSCredential |
| Alapértelmezett érték: | Current user |
| 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 |
-DisableKeepAlive
Azt jelzi, hogy a parancsmag a HTTP-fejlécben lévő
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | KeepAlive |
| 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 |
-Headers
Meghatározza a webes kérelem fejléceit. Írjon be egy kivonattáblát vagy szótárt.
UserAgent fejlécek beállításához használja a UserAgent paramétert. Ez a paraméter nem használható UserAgent vagy cookie-fejlécek megadására.
Paramétertulajdonságok
| Típus: | IDictionary |
| 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 |
-InFile
Lekéri a webes kérelem tartalmát egy fájlból.
Adjon meg egy elérési utat és egy fájlnevet. Ha kihagyja az elérési utat, az alapértelmezett hely az aktuális hely.
Paramétertulajdonságok
| Típus: | String |
| 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 |
-MaximumRedirection
Megadja, hogy a PowerShell hányszor irányítja át a kapcsolatot egy másodlagos egységes erőforrás-azonosítóhoz (URI), mielőtt a kapcsolat meghiúsul. Az alapértelmezett érték 5. A 0 (nulla) érték megakadályozza az összes átirányítást.
Paramétertulajdonságok
| Típus: | Int32 |
| Alapértelmezett érték: | 5 |
| 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 |
-Method
A webes kérelemhez használt metódust adja meg. A paraméter elfogadható értékei a következők:
- Alapértelmezett
- Törlés
- Megszerez
- Fej
- Egyesítés
- Beállítások
- Javítás
- Posta
- Put
- Nyom
Paramétertulajdonságok
| Típus: | WebRequestMethod |
| Alapértelmezett érték: | Default |
| Elfogadott értékek: | Default, Get, Head, Post, Put, Delete, Trace, Options, Merge, Patch |
| 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 |
-OutFile
Megadja azt a kimeneti fájlt, amelyhez ez a parancsmag menti a válasz törzsét. Adjon meg egy elérési utat és egy fájlnevet. Ha kihagyja az elérési utat, az alapértelmezett hely az aktuális hely.
Alapértelmezés szerint Invoke-WebRequest visszaadja az eredményeket a feldolgozási sornak.
Az eredmények fájlba és folyamatba való küldéséhez használja a Passthru paramétert.
Paramétertulajdonságok
| Típus: | String |
| 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 |
-PassThru
Azt jelzi, hogy a parancsmag a fájlba írás mellett az eredményeket is visszaadja. Ez a paraméter csak akkor érvényes, ha az OutFile paramétert is használja a parancs.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| 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 |
-Proxy
Proxykiszolgálót ad meg a kéréshez, ahelyett, hogy közvetlenül csatlakozik az interneterőforráshoz. Adja meg egy hálózati proxykiszolgáló URI-ját.
Paramétertulajdonságok
| Típus: | Uri |
| 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 |
-ProxyCredential
Olyan felhasználói fiókot ad meg, amely jogosult a proxyparaméter által megadott proxykiszolgáló használatára. Az alapértelmezett az aktuális felhasználó.
Írjon be egy felhasználónevet, például User01 vagy Domain01\User01, vagy írjon be egy PSCredential objektumot, például a Get-Credential parancsmag által létrehozott objektumot.
Ez a paraméter csak akkor érvényes, ha a parancsban a Proxy paramétert is használja. Nem használhatja a ProxyCredential és ProxyUseDefaultCredentials paramétereket ugyanabban a parancsban.
Paramétertulajdonságok
| Típus: | PSCredential |
| Alapértelmezett érték: | Current user |
| 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 |
-ProxyUseDefaultCredentials
Azt jelzi, hogy a parancsmag az aktuális felhasználó hitelesítő adatait használja a Proxy paraméter által megadott proxykiszolgáló eléréséhez.
Ez a paraméter csak akkor érvényes, ha a parancsban a Proxy paramétert is használja. Nem használhatja a ProxyCredential és ProxyUseDefaultCredentials paramétereket ugyanabban a parancsban.
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 |
-SessionVariable
Megadja azt a változót, amelyhez ez a parancsmag létrehoz egy webkérelem-munkamenetet, és menti azt az értékben.
Adjon meg egy változónevet a dollárjel ($) szimbólum nélkül.
Amikor megad egy munkamenet-változót, Invoke-WebRequest létrehoz egy webkérelem-munkamenet-objektumot, és hozzárendeli azt egy, a PowerShell-munkamenetben megadott névvel rendelkező változóhoz. A változót a parancs befejeződése után használhatja a munkamenetben.
A távoli munkamenetekkel ellentétben a webkérelmek munkamenete nem állandó kapcsolat. Ez egy objektum, amely információkat tartalmaz a kapcsolatról és a kérésről, beleértve a cookie-kat, a hitelesítő adatokat, a maximális átirányítási értéket és a felhasználói ügynök sztringet. Ezzel megoszthatja az állapotot és az adatokat a webes kérések között.
A webkérelem-munkamenet későbbi webes kérelmekben való használatához adja meg a munkamenet változóját a WebSession paraméter értékében. A PowerShell a webkérelem munkamenet-objektumában lévő adatokat használja az új kapcsolat létrehozásakor. Ha felül szeretne bírálni egy értéket a webes kérelem munkamenetében, használjon egy parancsmagparamétert, például UserAgent vagy Hitelesítő adatok. A paraméterértékek elsőbbséget élveznek a webes kérelem munkamenetében lévő értékekkel szemben.
Nem használhatja a SessionVariable és WebSession paramétereket ugyanabban a parancsban.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | SV |
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 |
-TimeoutSec
Megadja, hogy mennyi ideig lehet függőben a kérelem, mielőtt túllépi az időkorlátot. Adjon meg egy értéket másodpercek alatt. Az alapértelmezett érték, 0, meghatározatlan időtartamot ad meg.
A dns-lekérdezések visszatérése vagy időtúllépése akár 15 másodpercet is igénybe vehet. Ha a kérés tartalmaz egy feloldást igénylő gazdagépnevet, és TimeoutSec nullánál nagyobb, de 15 másodpercnél rövidebb értékre állítja be, az a WebException dobása előtt akár 15 másodpercet is igénybe vehet, és a kérés túllépi az időkorlátot.
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 |
-TransferEncoding
Megadja az átvitelkódoló HTTP-válaszfejléc értékét. A paraméter elfogadható értékei a következők:
- Felaprított
- Tömörít
- Leereszt
- GZip
- Személyazonosság
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Elfogadott értékek: | chunked, compress, deflate, gzip, identity |
| 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 |
-Uri
Annak az internetes erőforrásnak az egységes erőforrás-azonosítóját (URI) adja meg, amelyre a webkérelmet küldi. Adjon meg egy URI-t. Ez a paraméter támogatja a HTTP, HTTPS, FTP és FILE értékeket.
Ez a paraméter kötelező.
Paramétertulajdonságok
| Típus: | Uri |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | True |
| 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 |
-UseBasicParsing
Azt jelzi, hogy a parancsmag a válaszobjektumot a dokumentumobjektum-modell (DOM) elemzése nélküli HTML-tartalomhoz használja. Ez a paraméter akkor szükséges, ha az Internet Explorer nincs telepítve a számítógépeken, például Windows Server operációs rendszer Server Core-telepítésére.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| 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 |
-UseDefaultCredentials
Azt jelzi, hogy a parancsmag az aktuális felhasználó hitelesítő adatait használja a webes kérés elküldéséhez.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| 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 |
-UserAgent
Meghatároz egy user agent karakterláncot a webes kéréshez. Az alapértelmezett felhasználói ügynök hasonló az Mozilla/5.0 (Windows NT; Windows NT 6.1; en-US) WindowsPowerShell/3.0, és az egyes operációs rendszerek és platformok esetében kisebb eltéréseket mutat.
Ha egy webhelyet a legtöbb internetböngésző által használt szabványos felhasználói ügynök sztringgel szeretne tesztelni, használja a PSUserAgent osztály tulajdonságait, például Chrome, FireFox, InternetExplorer, Opera és Safari. Az alábbi parancs például a felhasználói ügynök sztringet használja az Internet Explorerhez
Paramétertulajdonságok
| Típus: | String |
| 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 |
-WebSession
Webkérelem-munkamenetet határoz meg.
Adja meg a változó nevét, beleértve a dollárjelet ($).
Ha felül szeretne bírálni egy értéket a webes kérelem munkamenetében, használjon egy parancsmagparamétert, például UserAgent vagy Hitelesítő adatok. A paraméterértékek elsőbbséget élveznek a webes kérelem munkamenetében lévő értékekkel szemben.
A távoli munkamenetekkel ellentétben a webkérelmek munkamenete nem állandó kapcsolat. Ez egy objektum, amely információkat tartalmaz a kapcsolatról és a kérésről, beleértve a cookie-kat, a hitelesítő adatokat, a maximális átirányítási értéket és a felhasználói ügynök sztringet. Ezzel megoszthatja az állapotot és az adatokat a webes kérések között.
Webkérelem-munkamenet létrehozásához adjon meg egy változónevet (dollárjel nélkül) egy parancs Invoke-WebRequest paraméterének értékébe.
Invoke-WebRequest létrehozza a munkamenetet, és megmenti a változóban. A következő parancsokban használja a változót a WebSession paraméter értékeként.
Nem használhatja a SessionVariable és WebSession paramétereket ugyanabban a parancsban.
Paramétertulajdonságok
| Típus: | WebRequestSession |
| 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.
Bevitelek
Object
A webes kérés törzsét a Invoke-WebRequest.