Add note about javascript might run (#4297)

* Add note about javascript might run Address #4296 * update comment based on PR feedback
MicrosoftDocs · May 13, 2019 · 14f7fa2 · 14f7fa2
1 parent e1d19ea
commit 14f7fa2
Show file tree

Hide file tree

Showing 8 changed files with 44 additions and 2 deletions.
diff --git a/reference/3.0/Microsoft.PowerShell.Utility/Invoke-RestMethod.md b/reference/3.0/Microsoft.PowerShell.Utility/Invoke-RestMethod.md
@@ -34,6 +34,11 @@ For JavaScript Object Notation (JSON) or XML, Windows PowerShell converts (or de
 
 This cmdlet is introduced in Windows PowerShell 3.0.
 
+> [!NOTE]
+> By default,
+> script code in the web page may be run when the page is being parsed to populate the `ParsedHtml` property.
+> Use the `-UseBasicParsing` switch to suppress this.
+
 ## Examples
 
 ### Example 1: Get the PowerShell RSS feed

diff --git a/reference/3.0/Microsoft.PowerShell.Utility/Invoke-WebRequest.md b/reference/3.0/Microsoft.PowerShell.Utility/Invoke-WebRequest.md
@@ -31,6 +31,12 @@ It parses the response and returns collections of forms, links, images, and othe
 
 This cmdlet was introduced in Windows PowerShell 3.0.
 
+> [!NOTE]
+> By default,
+> script code in the web page may be run when the page is being parsed to populate the `ParsedHtml` property.
+> Use the `-UseBasicParsing` switch to suppress this.
+
+
 ## EXAMPLES
 
 ### Example 1

diff --git a/reference/4.0/Microsoft.PowerShell.Utility/Invoke-RestMethod.md b/reference/4.0/Microsoft.PowerShell.Utility/Invoke-RestMethod.md
@@ -33,6 +33,11 @@ For JavaScript Object Notation (JSON) or XML, Windows PowerShell converts (or de
 
 This cmdlet is introduced in Windows PowerShell 3.0.
 
+> [!NOTE]
+> By default,
+> script code in the web page may be run when the page is being parsed to populate the `ParsedHtml` property.
+> Use the `-UseBasicParsing` switch to suppress this.
+
 ## Examples
 
 ### Example 1: Get the PowerShell RSS feed

diff --git a/reference/4.0/Microsoft.PowerShell.Utility/Invoke-WebRequest.md b/reference/4.0/Microsoft.PowerShell.Utility/Invoke-WebRequest.md
@@ -30,6 +30,11 @@ It parses the response and returns collections of forms, links, images, and othe
 
 This cmdlet was introduced in Windows PowerShell 3.0.
 
+> [!NOTE]
+> By default,
+> script code in the web page may be run when the page is being parsed to populate the `ParsedHtml` property.
+> Use the `-UseBasicParsing` switch to suppress this.
+
 ## EXAMPLES
 
 ### Example 1

diff --git a/reference/5.0/Microsoft.PowerShell.Utility/Invoke-RestMethod.md b/reference/5.0/Microsoft.PowerShell.Utility/Invoke-RestMethod.md
@@ -34,6 +34,11 @@ For JavaScript Object Notation (JSON) or XML, Windows PowerShell converts (or de
 
 This cmdlet is introduced in Windows PowerShell 3.0.
 
+> [!NOTE]
+> By default,
+> script code in the web page may be run when the page is being parsed to populate the `ParsedHtml` property.
+> Use the `-UseBasicParsing` switch to suppress this.
+
 ## Examples
 
 ### Example 1: Get the PowerShell RSS feed
@@ -104,11 +109,11 @@ Invoke-RestMethod -Method Post -Uri $url -Credential $Cred -Body $body -OutFile
 ### Example 3: Pass multiple headers
 
 ```powershell
-$headers = @{ 
+$headers = @{
     'userId' = 'UserIDValue'
     'token' = 'TokenValue'
 }
-Invoke-RestMethod -Uri $uri -Method Post -Headers $headers -Body $body 
+Invoke-RestMethod -Uri $uri -Method Post -Headers $headers -Body $body
 ```
 APIs often require passed headers for authentication, validation etc.
 

diff --git a/reference/5.0/Microsoft.PowerShell.Utility/Invoke-WebRequest.md b/reference/5.0/Microsoft.PowerShell.Utility/Invoke-WebRequest.md
@@ -30,6 +30,11 @@ It parses the response and returns collections of forms, links, images, and othe
 
 This cmdlet was introduced in Windows PowerShell 3.0.
 
+> [!NOTE]
+> By default,
+> script code in the web page may be run when the page is being parsed to populate the `ParsedHtml` property.
+> Use the `-UseBasicParsing` switch to suppress this.
+
 ## EXAMPLES
 
 ### Example 1: Send a web request

diff --git a/reference/5.1/Microsoft.PowerShell.Utility/Invoke-RestMethod.md b/reference/5.1/Microsoft.PowerShell.Utility/Invoke-RestMethod.md
@@ -35,6 +35,11 @@ For JavaScript Object Notation (JSON) or XML, Windows PowerShell converts (or de
 
 This cmdlet is introduced in Windows PowerShell 3.0.
 
+> [!NOTE]
+> By default,
+> script code in the web page may be run when the page is being parsed to populate the `ParsedHtml` property.
+> Use the `-UseBasicParsing` switch to suppress this.
+
 ## EXAMPLES
 
 ### Example 1: Get the PowerShell RSS feed

diff --git a/reference/5.1/Microsoft.PowerShell.Utility/Invoke-WebRequest.md b/reference/5.1/Microsoft.PowerShell.Utility/Invoke-WebRequest.md
@@ -26,11 +26,17 @@ Invoke-WebRequest [-UseBasicParsing] [-Uri] <Uri> [-WebSession <WebRequestSessio
 ```
 
 ## DESCRIPTION
+
 The **Invoke-WebRequest** cmdlet sends HTTP, HTTPS, FTP, and FILE requests to a web page or web service.
 It parses the response and returns collections of forms, links, images, and other significant HTML elements.
 
 This cmdlet was introduced in Windows PowerShell 3.0.
 
+> [!NOTE]
+> By default,
+> script code in the web page may be run when the page is being parsed to populate the `ParsedHtml` property.
+> Use the `-UseBasicParsing` switch to suppress this.
+
 ## EXAMPLES
 
 ### Example 1: Send a web request