|
2 | 2 | external help file: Microsoft.PowerShell.Commands.Utility.dll-Help.xml |
3 | 3 | Locale: en-US |
4 | 4 | Module Name: Microsoft.PowerShell.Utility |
5 | | -ms.date: 02/05/2025 |
| 5 | +ms.date: 12/04/2025 |
6 | 6 | online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.utility/invoke-restmethod?view=powershell-7.6&WT.mc_id=ps-gethelp |
7 | 7 | schema: 2.0.0 |
8 | 8 | aliases: |
@@ -329,8 +329,8 @@ pipe. |
329 | 329 | Invoke-RestMethod -Uri 'http://localhost/status' -PipeName 'MyLocalHttpPipe' |
330 | 330 | ``` |
331 | 331 |
|
332 | | -The host portion of the `-Uri` isn't used for network routing when `-PipeName` is supplied, but it |
333 | | -is included in the `Host` header of the HTTP request. |
| 332 | +The hostname portion of the **Uri** is ignored for network routing when you supply **PipeName**, but |
| 333 | +it's included in the `Host` header of the HTTP request. |
334 | 334 |
|
335 | 335 | ## PARAMETERS |
336 | 336 |
|
@@ -1369,15 +1369,15 @@ Specifies the name of a local Windows named pipe to use instead of a TCP socket |
1369 | 1369 | HTTP request. This lets you communicate with services that expose an HTTP-compatible protocol over |
1370 | 1370 | a named pipe without opening a TCP port. |
1371 | 1371 |
|
1372 | | -Only the local machine is supported. Remote / UNC pipe names aren't supported. Supplying a value |
1373 | | -that doesn't correspond to a listening named pipe endpoint results in a connection failure. |
| 1372 | +Only the local machine is supported. Remote UNC pipe names aren't supported. Supplying a value that |
| 1373 | +doesn't correspond to a listening named pipe endpoint results in a connection failure. |
1374 | 1374 |
|
1375 | | -When `-PipeName` is specified, the `-Uri` still determines the request path, query, and scheme used |
1376 | | -to build the HTTP request. The host portion of the `-Uri` is ignored for network routing because |
1377 | | -the named pipe transport is always local, but it still appears in headers such as `Host`. |
| 1375 | +When you specify **PipeName**, the hostname portion of the **Uri** is ignored for network routing. |
| 1376 | +The **Uri** still determines the request path, query, and scheme used to build the HTTP request. The |
| 1377 | +named pipe transport is always local, but the hostname still appears in HTTP headers. |
1378 | 1378 |
|
1379 | | -Security and access control for the pipe are governed by the server that created the pipe. The |
1380 | | -client (this cmdlet) doesn't modify pipe ACLs. |
| 1379 | +The server that creates the pipe governs security and access control for the pipe. This cmdlet, |
| 1380 | +acting as the client, doesn't modify pipe ACLs. |
1381 | 1381 |
|
1382 | 1382 | This parameter was added in PowerShell 7.6. |
1383 | 1383 |
|
|
0 commit comments