diff --git a/reference/6/Microsoft.PowerShell.Utility/Invoke-RestMethod.md b/reference/6/Microsoft.PowerShell.Utility/Invoke-RestMethod.md index 562f1c861b35..8c58d7129875 100644 --- a/reference/6/Microsoft.PowerShell.Utility/Invoke-RestMethod.md +++ b/reference/6/Microsoft.PowerShell.Utility/Invoke-RestMethod.md @@ -177,6 +177,7 @@ Allows sending of credentials and secrets over unencrypted connections. By defau > **Warning**: Using this parameter is not secure and is not recommended. It is provided only for compatibility with legacy systems that cannot provide encrypted connections. Use at your own risk. +This feature was added in PowerShell 6.0.0. ```yaml Type: SwitchParameter @@ -202,6 +203,7 @@ Available Authentication Options: Supplying **-Authentication** will override any `Authorization` headers supplied to **-Headers** or included in **-WebSession**. +This feature was added in PowerShell 6.0.0. ```yaml Type: WebAuthenticationType @@ -228,7 +230,7 @@ For other request types (such as POST), the body is set as the value of the requ When the body is a form, or it is the output of another `Invoke-WebRequest` call, PowerShell sets the request content to the form fields. -The **-Body** parameter may also accept a `System.Net.Http.MultipartFormDataContent` object. This will facilitate `multipart/form-data` requests. When a `MultipartFormDataContent` object is supplied for **-Body**, any Content related headers supplied to the **-ContentType**, **-Headers**, or **-WebSession** parameters will be overridden by the Content headers of the `MultipartFormDataContent` object. +The **-Body** parameter may also accept a `System.Net.Http.MultipartFormDataContent` object. This will facilitate `multipart/form-data` requests. When a `MultipartFormDataContent` object is supplied for **-Body**, any Content related headers supplied to the **-ContentType**, **-Headers**, or **-WebSession** parameters will be overridden by the Content headers of the `MultipartFormDataContent` object. This feature was added in PowerShell 6.0.0. ```yaml Type: Object @@ -249,8 +251,6 @@ Enter a variable that contains a certificate or a command or expression that get To find a certificate, use `Get-PfxCertificate` or use the `Get-ChildItem` cmdlet in the Certificate (`Cert:`) drive. If the certificate is not valid or does not have sufficient authority, the command fails. -> **Note**: This feature may not work on OS platforms where `libcurl` is configured with a TLS provider other than OpenSSL. - ```yaml Type: X509Certificate Parameter Sets: (All) @@ -338,6 +338,8 @@ Invoke-WebRequest -uri 'https://api.contoso.com/widget/' -CustomMethod 'TEST' This makes a `TEST` HTTP request to the API. +This feature was added in PowerShell 6.0.0. + ```yaml Type: String Parameter Sets: StandardMethod, CustomMethod @@ -372,6 +374,8 @@ Indicates the cmdlet should follow relation links. To set how many times to follow relation links, use the **-MaximumFollowRelLink** parameter. +This feature was added in PowerShell 6.0.0. + ```yaml Type: SwitchParameter Parameter Sets: (All) @@ -599,6 +603,8 @@ Indicates the cmdlet should preserve the `Authorization` header, when present, a By default, the cmdlet strips the `Authorization` header before redirecting. Specifying this parameter disables this logic for cases where the header needs to be sent to the redirection location. +This feature was added in PowerShell 6.0.0. + ```yaml Type: SwitchParameter Parameter Sets: (All) @@ -615,6 +621,8 @@ Accept wildcard characters: False Uses a proxy server for the request, rather than connecting directly to the Internet resource. Enter the URI of a network proxy server. +This feature was added in PowerShell 6.0.0. + ```yaml Type: Uri Parameter Sets: (All) @@ -669,6 +677,7 @@ Accept wildcard characters: False ### -ResponseHeadersVariable Creates a Response Headers Dictionary and saves it in the value of the specified variable. The the keys of the dictionary will contain the field names of the Response Header returned by the web server and the values will be the respective field values. +This feature was added in PowerShell 6.0.0. ```yaml Type: String @@ -758,6 +767,7 @@ Skips certificate validation checks. This includes all validations such as expir > **Warning**: Using this parameter is not secure and is not recommended. This switch is only intended to be used against known hosts using a self-signed certificate for testing purposes. Use at your own risk. +This feature was added in PowerShell 6.0.0. ```yaml Type: SwitchParameter @@ -778,6 +788,8 @@ This switch should be used for sites that require header values that do not conf This will disable validation for values passed to the **-ContentType**, **-Headers** and **-UserAgent** parameters. +This feature was added in PowerShell 6.0.0. + ```yaml Type: SwitchParameter Parameter Sets: (All) @@ -795,7 +807,9 @@ Sets the SSL/TLS protocols that are permissible for the web request. By default **-SslProtocol** uses the `WebSslProtocol` Flag Enum. It is possible to supply more than one protocol using flag notation or combining multiple `WebSslProtocol` options with `-bor`, however supplying multiple protocols is not supported on all platforms. -> **Note**: This feature may not work on OS platforms where `libcurl` is configured with a TLS provider other than OpenSSL. +> **Note**: On non-Windows platforms it may not be possible to supply `'Tls, Tls12'` as an option. + +This feature was added in PowerShell 6.0.0. ```yaml Type: WebSslProtocol @@ -839,6 +853,8 @@ The OAuth or Bearer token to include in the request. **-Token** is required by c Invoke-RestMethod -Uri $uri -Authentication OAuth -Token (Read-Host -AsSecureString) ``` +This feature was added in PowerShell 6.0.0. + ```yaml Type: SecureString Parameter Sets: (All) @@ -996,8 +1012,6 @@ If the request returns JSON strings, `Invoke-RestMethod` returns a PSObject that ## Notes -Some features may not be available on all platforms. - ## Related Links [ConvertTo-Json](ConvertTo-Json.md) diff --git a/reference/6/Microsoft.PowerShell.Utility/Invoke-WebRequest.md b/reference/6/Microsoft.PowerShell.Utility/Invoke-WebRequest.md index 3fe9dd61c6c2..05ef9eb71e5b 100644 --- a/reference/6/Microsoft.PowerShell.Utility/Invoke-WebRequest.md +++ b/reference/6/Microsoft.PowerShell.Utility/Invoke-WebRequest.md @@ -192,6 +192,7 @@ Allows sending of credentials and secrets over unencrypted connections. By defau > **Warning**: Using this parameter is not secure and is not recommended. It is provided only for compatibility with legacy systems that cannot provide encrypted connections. Use at your own risk. +This feature was added in PowerShell 6.0.0. ```yaml Type: SwitchParameter @@ -217,6 +218,7 @@ Available Authentication Options: Supplying **-Authentication** will override any `Authorization` headers supplied to **-Headers** or included in **-WebSession**. +This feature was added in PowerShell 6.0.0. ```yaml Type: WebAuthenticationType @@ -241,7 +243,7 @@ The **-Body** parameter can be used to specify a list of query parameters or spe When the input is a GET request and the body is an `IDictionary` (typically, a hash table), the body is added to the URI as query parameters. For other request types (such as POST), the body is set as the value of the request body in the standard name=value format. -The **-Body** parameter may also accept a `System.Net.Http.MultipartFormDataContent` object. This will facilitate `multipart/form-data` requests. When a `MultipartFormDataContent` object is supplied for **-Body**, any Content related headers supplied to the **-ContentType**, **-Headers**, or **-WebSession** parameters will be overridden by the Content headers of the `MultipartFormDataContent` object. +The **-Body** parameter may also accept a `System.Net.Http.MultipartFormDataContent` object. This will facilitate `multipart/form-data` requests. When a `MultipartFormDataContent` object is supplied for **-Body**, any Content related headers supplied to the **-ContentType**, **-Headers**, or **-WebSession** parameters will be overridden by the Content headers of the `MultipartFormDataContent` object. This feature was added in PowerShell 6.0.0. ```yaml Type: Object @@ -262,8 +264,6 @@ Enter a variable that contains a certificate or a command or expression that get To find a certificate, use `Get-PfxCertificate` or use the `Get-ChildItem` cmdlet in the Certificate (`Cert:`) drive. If the certificate is not valid or does not have sufficient authority, the command fails. -> **Note**: This feature may not work on OS platforms where `libcurl` is configured with a TLS provider other than OpenSSL. - ```yaml Type: X509Certificate Parameter Sets: (All) @@ -351,6 +351,8 @@ Invoke-WebRequest -uri 'https://api.contoso.com/widget/' -CustomMethod 'TEST' This makes a `TEST` HTTP request to the API. +This feature was added in PowerShell 6.0.0. + ```yaml Type: String Parameter Sets: CustomMethod, CustomMethodNoProxy @@ -526,6 +528,8 @@ Indicates that the cmdlet will not use a proxy to reach the destination. When you need to bypass the proxy configured in the environment, use this switch. +This feature was added in PowerShell 6.0.0. + ```yaml Type: SwitchParameter Parameter Sets: StandardMethodNoProxy, CustomMethodNoProxy @@ -579,6 +583,8 @@ Indicates the cmdlet should preserve the `Authorization` header, when present, a By default, the cmdlet strips the `Authorization` header before redirecting. Specifying this parameter disables this logic for cases where the header needs to be sent to the redirection location. +This feature was added in PowerShell 6.0.0. + ```yaml Type: SwitchParameter Parameter Sets: (All) @@ -721,6 +727,8 @@ Skips certificate validation checks. This includes all validations such as expir > **Warning**: Using this parameter is not secure and is not recommended. This switch is only intended to be used against known hosts using a self-signed certificate for testing purposes. Use at your own risk. +This feature was added in PowerShell 6.0.0. + ```yaml Type: SwitchParameter Parameter Sets: (All) @@ -740,6 +748,8 @@ This switch should be used for sites that require header values that do not conf This will disable validation for values passed to the **-ContentType**, **-Headers** and **-UserAgent** parameters. +This feature was added in PowerShell 6.0.0. + ```yaml Type: SwitchParameter Parameter Sets: (All) @@ -757,7 +767,9 @@ Sets the SSL/TLS protocols that are permissible for the web request. By default **-SslProtocol** uses the `WebSslProtocol` Flag Enum. It is possible to supply more than one protocol using flag notation or combining multiple `WebSslProtocol` options with `-bor`, however supplying multiple protocols is not supported on all platforms. -> **Note**: This feature may not work on OS platforms where `libcurl` is configured with a TLS provider other than OpenSSL. +> **Note**: On non-Windows platforms it may not be possible to supply `'Tls, Tls12'` as an option. + +This feature was added in PowerShell 6.0.0. ```yaml Type: WebSslProtocol @@ -801,6 +813,8 @@ The OAuth or Bearer token to include in the request. **-Token** is required by c Invoke-WebRequest -Uri $uri -Authentication OAuth -Token (Read-Host -AsSecureString) ``` +This feature was added in PowerShell 6.0.0. + ```yaml Type: SecureString Parameter Sets: (All) @@ -955,8 +969,6 @@ You can pipe the body of a web request to `Invoke-WebRequest`. ## NOTES -Some features may not be available on all platforms. - Beginning with PowerShell 6.0.0 `Invoke-WebRequest` supports basic parsing only. ## RELATED LINKS