Invoke-WebRequest
İnternet'te bir web sayfasından içerik alır.
Syntax
Default (Varsayılan)
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
Invoke-WebRequest cmdlet'i HTTP, HTTPS, FTP ve FILE isteklerini bir web sayfasına veya web hizmetine gönderir. Yanıtı ayrıştırarak form, bağlantı, görüntü ve diğer önemli HTML öğeleri koleksiyonlarını döndürür.
Bu cmdlet, Windows PowerShell 3.0'da kullanıma sunulmuştur.
Uyarı
Varsayılan olarak, Invoke-WebRequest web sayfasının içeriğini ayrıştırmaktadır. Web sayfasındaki betik kodu, sayfa ayrıştırıldığında çalıştırılabilir.
Microsoft, 9 Aralık 2025'teCVE-2025-54100 için varsayılan davranışını Invoke-WebRequestdeğiştiren bir güvenlik güncelleştirmesi yayımladı. Güncelleştirmeleri yükledikten sonra, komutu kullandığınızda Invoke-WebRequest betik yürütme riskiyle ilgili güvenlik uyarısı içeren aşağıdaki onay istemini görürsünüz:
Security Warning: Script Execution Risk
Invoke-WebRequest parses the content of the web page. Script code in the web page might be
run when the page is parsed.
RECOMMENDED ACTION:
Use the -UseBasicParsing switch to avoid script code execution.
Do you want to continue?
Onay istemini önlemek için UseBasicParsing parametresini kullanmanız gerekir. UseBasicParsing parametresini kullanmadan bu istemi atlamanın bir yolu yoktur. komut istemine "Y" yanıtını verirseniz, komut web sayfası içeriğinin tam ayrıştırılmasıyla çalışır ve bu da web sayfasında betik kodunu çalıştırabilir.
Bu güvenlik güncelleştirmesi hakkında daha fazla bilgi için bkz. PowerShell 5.1: Web içeriğinden betik yürütülmesini engelleme.
Varsayılan olarak, HTTP isteği aşağıdaki HTTP üst bilgileri için varsayılan değerleri içerir:
HostUser-Agent
Diğer üst bilgileri eklemek veya varsayılan değerleri geçersiz kılmak için Headers parametresini kullanın.
Bu komut , iwrveya curl diğer adları kullanılarak wgetçalıştırılabilir.
Örnekler
Örnek 1: Web isteği gönderme
Bu örnekte, Bing.com sitesine web isteği göndermek için Invoke-WebRequest cmdlet'i kullanılır.
$Response = Invoke-WebRequest -UseBasicParsing -Uri https://www.bing.com?q=how+many+feet+in+a+mile
$Response.InputFields |
Where-Object Name -Like "* Value" |
Select-Object Name, Value
Name Value
---- -----
From Value 1
To Value 5280
tarafından Invoke-WebRequest döndürülen veriler değişkende $Response depolanır. Yanıtın InputFields özelliği form alanlarını içerir.
Where-Object, form alanlarını Name özelliğinin "* Değer" gibi olduğu alanlara filtrelemek için kullanılır. Filtrelenen sonuçlar, Select-Object ve Değer özelliklerini seçmek için yönlendirilir.
Örnek 2: Durum bilgisi olan bir web hizmeti kullanma
Bu örnekte, Invoke-WebRequest cmdlet'in Facebook gibi durum bilgisi olan bir web hizmetiyle nasıl kullanılacağı gösterilmektedir.
$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
İlk komut, oturum açma isteği göndermek için Invoke-WebRequest cmdlet'ini kullanır. komutu, SessionVariable parametresinin değeri için "FB" değerini belirtir ve sonucu $R değişkenine kaydeder. Komut tamamlandığında, $R değişkeni bir HtmlWebResponseObject ve $FB değişkeni bir WebRequestSession nesnesi içerir.
Invoke-WebRequest cmdlet'i facebook'ta oturum açtıktan sonra, değişkenindeki web yanıt nesnesinin $R özelliği kullanıcının başarıyla oturum açtığını gösterir.
Örnek 3: Web sayfasından bağlantı alma
Bu komut, bağlantıları bir web sayfasında alır.
(Invoke-WebRequest -Uri "https://devblogs.microsoft.com/powershell/").Links.Href
Invoke-WebRequest cmdlet'i web sayfası içeriğini alır. Ardından döndürülen
Örnek 4: Invoke-WebRequest gelen başarılı olmayan iletileri yakalama
Invoke-WebRequest başarılı olmayan bir HTTP iletisiyle (404, 500 vb.) karşılaştığında çıkış döndürmez ve sonlandırıcı bir hata oluşturur. Hatayı yakalamak ve StatusCode görüntülemek için yürütmeyi try/catch bir bloğun içine alabilirsiniz.
try
{
$Response = Invoke-WebRequest -Uri "www.microsoft.com/unkownhost"
# This will only execute if the Invoke-WebRequest is successful.
$StatusCode = $Response.StatusCode
}
catch
{
$StatusCode = $_.Exception.Response.StatusCode.value__
}
$StatusCode
404
Sonlandırma hatası, catch nesnesinden StatusCode alan bloğu tarafından yakalanıyor.
Örnek 5: Aynı anda birden çok dosya indirme
Invoke-WebRequest cmdlet'i aynı anda yalnızca bir dosya indirebilir. Aşağıdaki örnek, aynı anda birden çok dosya indirmek üzere birden çok iş parçacığı işi oluşturmak için Start-ThreadJob kullanır.
$baseUri = 'https://github.com/PowerShell/PowerShell/releases/download'
$files = @(
@{
Uri = "$baseUri/v7.3.0-preview.5/PowerShell-7.3.0-preview.5-win-x64.msi"
OutFile = 'PowerShell-7.3.0-preview.5-win-x64.msi'
},
@{
Uri = "$baseUri/v7.3.0-preview.5/PowerShell-7.3.0-preview.5-win-x64.zip"
OutFile = 'PowerShell-7.3.0-preview.5-win-x64.zip'
},
@{
Uri = "$baseUri/v7.2.5/PowerShell-7.2.5-win-x64.msi"
OutFile = 'PowerShell-7.2.5-win-x64.msi'
},
@{
Uri = "$baseUri/v7.2.5/PowerShell-7.2.5-win-x64.zip"
OutFile = 'PowerShell-7.2.5-win-x64.zip'
}
)
$jobs = @()
foreach ($file in $files) {
$jobs += Start-ThreadJob -Name $file.OutFile -ScriptBlock {
$params = $Using:file
Invoke-WebRequest @params
}
}
Write-Host "Downloads started..."
Wait-Job -Job $jobs
foreach ($job in $jobs) {
Receive-Job -Job $job
}
Uyarı
Cmdlet'ini Start-ThreadJob kullanmak için PowerShell Galerisi ThreadJob modülünü yüklemeniz gerekir.
Parametreler
-Body
İsteğin gövdesini belirtir. Gövde, üst bilgileri izleyen isteğin içeriğidir.
Gövde değerini Invoke-WebRequestüzerine yönlendirebilirsiniz.
Body parametresi, sorgu parametrelerinin listesini belirtmek veya yanıtın içeriğini belirtmek için kullanılabilir.
Giriş bir GET isteği olduğunda ve gövde bir IDictionary (genellikle bir karma tablosu) olduğunda, gövde sorgu parametreleri olarak URI'ye eklenir. Diğer istek türleri (POST gibi) için gövde, standart name=value biçimde istek gövdesinin değeri olarak ayarlanır.
Gövde bir form olduğunda veya bir Invoke-WebRequest çağrısının çıktısı olduğunda, PowerShell istek içeriğini form alanlarına ayarlar.
Örneğin:
$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
- veya-
Invoke-RestMethod https://website.com/service.aspx -Body $r.Forms[0]
Parametre özellikleri
| Tür: | Object |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | True |
| Ö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 |
-Certificate
Güvenli bir web isteği için kullanılan istemci sertifikasını belirtir. Sertifikayı içeren bir değişken veya sertifikayı alan bir komut veya ifade girin.
Sertifika bulmak için Get-PfxCertificate kullanın veya Sertifika (Get-ChildItem) sürücüsündeki Cert: cmdlet'ini kullanın. Sertifika geçerli değilse veya yeterli yetkiye sahip değilse, komut başarısız olur.
Parametre özellikleri
| Tür: | X509Certificate |
| 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 |
-CertificateThumbprint
İsteği gönderme izni olan bir kullanıcı hesabının dijital ortak anahtar sertifikasını (X509) belirtir. Sertifikanın parmak izini girin.
Sertifikalar, istemci sertifikası tabanlı kimlik doğrulamasında kullanılır. Sertifikalar yalnızca yerel kullanıcı hesaplarıyla eşlenebilir, etki alanı hesaplarıyla eşlenemez.
Sertifika parmak izini görmek için Get-Item veya Get-ChildItem komutunu kullanarak Cert:\CurrentUser\Myiçinde sertifikayı bulun.
Parametre özellikleri
| Tür: | String |
| 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 |
-ContentType
Web isteğinin içerik türünü belirtir.
ContentType değeri kodlama biçimini (charsetolarak) içeriyorsa, cmdlet web isteğinin gövdesini kodlamak için bu biçimi kullanır.
ContentType kodlama biçimi belirtmiyorsa, bunun yerine varsayılan kodlama biçimi kullanılır. Kodlama biçimine sahip bir ContentType örneği, text/plain; charset=iso-8859-5 alfabesini belirten şeklindedir.
parametresini atlarsanız, içerik türü kullandığınız HTTP yöntemine göre farklı olabilir:
- POST yöntemi için içerik türü
application/x-www-form-urlencoded - PUT yöntemi için içerik türü
application/json - Diğer yöntemler için içerik türü istekte belirtilmez
Dosyayı karşıya yüklemek için InFile parametresini kullanıyorsanız, içerik türünü ayarlamanız gerekir.
Genellikle türü application/octet-streamolmalıdır. Ancak, içerik türünü uç noktanın gereksinimlerine göre ayarlamanız gerekir.
Parametre özellikleri
| Tür: | String |
| 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 |
-Credential
İsteği gönderme izni olan bir kullanıcı hesabı belirtir. Varsayılan değer mevcut kullanıcıdır.
User01 veya Domain01\User01gibi bir kullanıcı adı yazın veya cmdlet'i tarafından oluşturulan Get-Credential nesnesi girin.
Kimlik bilgileri bir PSCredential nesnesinde depolanır ve parola SecureStringolarak depolanır.
Uyarı
SecureString veri koruması hakkında daha fazla bilgi için bkz. SecureString ne kadar güvenli?.
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 |
-DisableKeepAlive
cmdlet'in HTTP üst bilgisindeki
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 |
-Headers
Web isteğinin üst bilgilerini belirtir. Bir hash tablosu veya sözlük girin.
UserAgent üst bilgilerini
Parametre özellikleri
| Tür: | IDictionary |
| 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 |
-InFile
Web isteği gövdesinin içeriğini bir dosyadan alır. Bir yol ve dosya adı girin. Yolu atlarsanız, varsayılan ayar şu anki konumdur.
İsteğin içerik türünü de ayarlamanız gerekir. Örneğin, bir dosyayı karşıya yüklemek için içerik türünü ayarlamanız gerekir. Genellikle türü application/octet-streamolmalıdır. Ancak, içerik türünü uç noktanın gereksinimlerine göre ayarlamanız gerekir.
Parametre özellikleri
| Tür: | String |
| 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 |
-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önlendirecek olduğunu belirtir. Varsayılan değer 5'tir. 0 (sıfır) değeri tüm yeniden yönlendirmeyi engeller.
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 |
-Method
Web isteği için kullanılan yöntemi belirtir. Bu parametre için kabul edilebilir değerler şunlardır:
DefaultDeleteGetHeadMergeOptionsPatchPostPutTrace
Parametre özellikleri
| Tür: | WebRequestMethod |
| Default value: | None |
| Kabul edilen değerler: | Default, Get, Head, Post, Put, Delete, Trace, Options, Merge, Patch |
| 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 |
-OutFile
Bu cmdlet'in yanıt gövdesini kaydettiği çıkış dosyasını belirtir. Bir yol ve dosya adı girin. Yolu atlarsanız, varsayılan ayar şu anki konumdur.
Varsayılan olarak, Invoke-WebRequest sonuçları işlem hattına döndürür. Sonuçları bir dosyaya ve işlem hattına göndermek için PassThru parametresini kullanın.
Parametre özellikleri
| Tür: | String |
| 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 |
-PassThru
Cmdlet'in sonuçları döndürdüğünü ve bunları bir dosyaya yazdığını gösterir. Bu parametre yalnızca komutta OutFile parametresi de kullanıldığında geçerlidir.
Uyarı
PassThru parametresini kullandığınızda, çıkış işlem hattına yazılır ancak dosya boş olur. Daha fazla bilgi için bkz. PowerShell Sorunu #15409.
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 |
-Proxy
doğrudan İnternet kaynağına bağlanmak yerine istek için bir ara sunucu belirtir. Ağ proxy sunucusunun URI'sini girin.
Parametre özellikleri
| Tür: | Uri |
| 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 |
-ProxyCredential
Proxy parametresi tarafından belirtilen ara sunucuyu kullanma izni olan bir kullanıcı hesabı belirtir. Varsayılan değer mevcut kullanıcıdır.
User01 veya Domain01\User01gibi bir kullanıcı adı yazın ya da cmdlet'i tarafından oluşturulmuş bir Get-Credential nesnesi girin.
Bu parametre yalnızca komutta Proxy parametresi de kullanıldığında geçerlidir. ProxyCredential ve ProxyUseDefaultCredentials parametrelerini aynı komutta kullanamazsınız.
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 |
-ProxyUseDefaultCredentials
cmdlet'in, Proxy parametresi tarafından belirtilen ara sunucuya erişmek için geçerli kullanıcının kimlik bilgilerini kullandığını gösterir.
Bu parametre yalnızca komutta Proxy parametresi de kullanıldığında geçerlidir. ProxyCredential ve ProxyUseDefaultCredentials parametrelerini aynı komutta kullanamazsınız.
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 |
-SessionVariable
Bu cmdlet'in bir web isteği oturumu oluşturduğu ve bunu değere kaydettiği bir değişken belirtir.
Dolar işareti ($) simgesi olmadan bir değişken adı girin.
Bir oturum değişkeni belirttiğinizde, Invoke-WebRequest bir web isteği oturum nesnesi oluşturur ve bunu PowerShell oturumunuzda belirtilen ada sahip bir değişkene atar. Komutu tamamlar tamamlamaz, değişkeni oturumunuzda kullanabilirsiniz.
Uzak oturumdan farklı olarak, web isteği oturumu kalıcı bir bağlantı değildir. Bağlantı ve istek hakkında çerezler, kimlik bilgileri, maksimum yönlendirme sayısı ve kullanıcı aracı dizgesi gibi bilgileri içeren bir nesnedir. Web istekleri arasında durum ve veri paylaşmak için bunu kullanabilirsiniz.
Sonraki web isteklerinde web isteği oturumunu kullanmak için WebSession parametresinin değerinde oturum değişkenini belirtin. PowerShell, yeni bağlantı kurarken web isteği oturum nesnesindeki verileri kullanır. Web isteği oturumundaki bir değeri geçersiz kılmak için UserAgent veya Credentialgibi bir cmdlet parametresi kullanın. Parametre değerleri web isteği oturumundaki değerlerden önceliklidir.
SessionVariable ve WebSession parametrelerini aynı komutta kullanamazsınız.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | SV |
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 |
-TimeoutSec
İsteğin zaman aşımına uğramadan önce ne kadar süreyle beklenebileceğini belirtir. Saniye olarak bir değer girin. Varsayılan değer olan 0, süresiz bir zaman aşımı belirtir.
Etki Alanı Adı Sistemi (DNS) sorgusu döndürülmesi veya zaman aşımına uğrarken 15 saniye kadar sürebilir. İsteğiniz çözüm gerektiren bir konak adı içeriyorsa ve TimeoutSec sıfırdan büyük ama 15 saniyeden kısa bir değere ayarlarsanız, bir WebException atılması 15 saniye veya daha fazla sürebilir ve isteğiniz zaman aşımına uğrar.
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 |
-TransferEncoding
Aktarım kodlaması HTTP yanıt üst bilgisi için bir değer belirtir. Bu parametre için kabul edilebilir değerler şunlardır:
ChunkedCompressDeflateGZipIdentity
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Kabul edilen değerler: | chunked, compress, deflate, gzip, identity |
| 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 |
-Uri
Web isteğinin gönderildiği İnternet kaynağının Tekdüzen Kaynak Tanımlayıcısını (URI) belirtir. Bir URI girin. Bu parametre HTTP, HTTPS, FTP ve FILE değerlerini destekler.
Bu parametre gereklidir. Uri parametre adı isteğe bağlıdır.
Parametre özellikleri
| Tür: | Uri |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 0 |
| Zorunlu: | True |
| İş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 |
-UseBasicParsing
Cmdlet'in Belge Nesne Modeli (DOM) ayrıştırması olmadan HTML içeriği için yanıt nesnesini kullandığını gösterir. Bu parametre, Windows Server işletim sisteminin Sunucu Çekirdeği yüklemesi gibi bilgisayarlarda Internet Explorer yüklü olmadığında gereklidir.
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 |
-UseDefaultCredentials
Cmdlet'in geçerli kullanıcının kimlik bilgilerini kullanarak web isteğini gönderdiğini 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 |
-UserAgent
Web isteği için bir kullanıcı aracısı dizesi belirtir. Varsayılan kullanıcı aracısı, her işletim sistemi ve platform için küçük varyasyonları olan Mozilla/5.0 (Windows NT; Windows NT 6.1; en-US) WindowsPowerShell/3.0 benzerdir.
Web sitesini çoğu İnternet tarayıcısı tarafından kullanılan standart kullanıcı aracısı dizesiyle test etmek için Chrome, Firefox, InternetExplorer, Opera ve Safari gibi PSUserAgent sınıfının özelliklerini kullanın. Örneğin, aşağıdaki komut Internet Explorer için kullanıcı aracısı dizesini kullanır: Invoke-WebRequest -Uri https://website.com/ -UserAgent ([Microsoft.PowerShell.Commands.PSUserAgent]::InternetExplorer)
Parametre özellikleri
| Tür: | String |
| 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 |
-WebSession
Belirli bir web isteği oturumunu belirtir. Dolar işareti ($) dahil olmak üzere değişken adını girin.
Web isteği oturumundaki bir değeri geçersiz kılmak için UserAgent veya Credentialgibi bir cmdlet parametresi kullanın. Parametre değerleri web isteği oturumundaki değerlerden önceliklidir.
Uzak oturumun aksine, web isteği oturumu kalıcı bir bağlantı değildir. Bağlantı ve istek hakkında tanımlama bilgileri, kimlik bilgileri, maksimum yeniden yönlendirme değeri ve kullanıcı aracısı dizesi gibi bilgileri içeren bir nesnedir. Web istekleri arasında durum ve veri paylaşmak için bunu kullanabilirsiniz.
Web isteği oturumu oluşturmak için bir komutunun Invoke-WebRequest parametresinin değerine dolar işareti olmadan bir değişken adı girin.
Invoke-WebRequest oturumu oluşturur ve bu oturumu değişkene kaydeder. Sonraki komutlarda, WebSession parametresinin değeri olarak değişkenini kullanın.
SessionVariable ve WebSession parametrelerini aynı komutta kullanamazsınız.
Parametre özellikleri
| Tür: | WebRequestSession |
| 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
Object
Web isteğinin gövdesini bu cmdlet'e iletebilirsiniz.
Çıkışlar
HtmlWebResponseObject
Bu cmdlet, web isteğinin sonucunu temsil eden yanıt nesnesini döndürür.
Notlar
Windows PowerShell, Invoke-WebRequestiçin aşağıdaki diğer adları içerir:
iwrcurlwget
