New-WebServiceProxy
创建一个 Web 服务代理对象，该对象允许你在 PowerShell 中使用和管理 Web 服务。
语法
New-WebServiceProxy
[-Uri] <Uri>
[[-Class] <String>]
[[-Namespace] <String>]
[<CommonParameters>] New-WebServiceProxy
[-Uri] <Uri>
[[-Class] <String>]
[[-Namespace] <String>]
[-Credential <PSCredential>]
[<CommonParameters>] New-WebServiceProxy
[-Uri] <Uri>
[[-Class] <String>]
[[-Namespace] <String>]
[-UseDefaultCredential]
[<CommonParameters>] 说明
New-WebServiceProxy cmdlet 允许在 PowerShell 中使用 Web 服务。 该 cmdlet 连接到 Web 服务并在 PowerShell 中创建 Web 服务代理对象。 可以使用代理对象来管理 Web 服务。
Web 服务是基于 XML 的程序，它通过网络交换数据，尤其是通过 Internet 交换数据。 Microsoft .NET Framework 提供 Web 服务代理对象，这些对象将 Web 服务表示为 .NET Framework 对象。
示例
示例 1：为 Web 服务创建代理
此示例在 Windows PowerShell 中创建计算器 Web 服务的 .NET Framework 代理。
$calc = New-WebServiceProxy -Uri "http://www.dneonline.com/calculator.asmx?wsdl"示例 2：为 Web 服务创建代理并指定命名空间和类
此示例使用 New-WebServiceProxy cmdlet 创建计算器 Web 服务的 .NET Framework 代理。
$URI = "http://www.dneonline.com/calculator.asmx?wsdl"
$calc = New-WebServiceProxy -Uri $URI -Namespace "WSProxy" -Class "Calculator"该命令使用 Uri 参数指定 URI 和 命名空间 和 类 参数来指定对象的命名空间和类。
示例 3：显示 Web 服务代理的方法
$calc | Get-Member -MemberType method
TypeName: WSProxy.Calculator
Name MemberType Definition
---- ---------- ----------
Abort Method void Abort()
Add Method int Add(int intA, int intB)
AddAsync Method void AddAsync(int intA, int intB), void AddAsync(int intA,
BeginAdd Method System.IAsyncResult BeginAdd(int intA, int intB, System.Asy
BeginDivide Method System.IAsyncResult BeginDivide(int intA, int intB, System.
BeginMultiply Method System.IAsyncResult BeginMultiply(int intA, int intB, Syste
BeginSubtract Method System.IAsyncResult BeginSubtract(int intA, int intB, Syste
CancelAsync Method void CancelAsync(System.Object userState)
CreateObjRef Method System.Runtime.Remoting.ObjRef CreateObjRef(type requestedT
Discover Method void Discover()
Dispose Method void Dispose(), void IDisposable.Dispose()
Divide Method int Divide(int intA, int intB)
DivideAsync Method void DivideAsync(int intA, int intB), void DivideAsync(int
EndAdd Method int EndAdd(System.IAsyncResult asyncResult)
EndDivide Method int EndDivide(System.IAsyncResult asyncResult)
EndMultiply Method int EndMultiply(System.IAsyncResult asyncResult)
EndSubtract Method int EndSubtract(System.IAsyncResult asyncResult)
Equals Method bool Equals(System.Object obj)
GetHashCode Method int GetHashCode()
GetLifetimeService Method System.Object GetLifetimeService()
GetType Method type GetType()
InitializeLifetimeService Method System.Object InitializeLifetimeService()
Multiply Method int Multiply(int intA, int intB)
MultiplyAsync Method void MultiplyAsync(int intA, int intB), void MultiplyAsync(
Subtract Method int Subtract(int intA, int intB)
SubtractAsync Method void SubtractAsync(int intA, int intB), void SubtractAsync(
ToString Method string ToString()此示例使用 Get-Member cmdlet 在 $calc 变量中显示 Web 服务代理对象的方法。 以下示例使用这些方法。
请注意，代理对象的 TypeName WebServiceProxy 反映了上一示例中指定的命名空间和类名。
示例 4：使用 Web 服务代理
PS> $calc.Multiply(6,7)
42此示例使用存储在 $calc 变量中的 Web 服务代理。 该命令使用代理的 Multiply 方法。
参数
-Class
指定 cmdlet 为 Web 服务创建的代理类的名称。 此参数的值与 Namespace 参数一起使用，以提供类的完全限定名称。 默认值是从统一资源标识符（URI）生成的。
| 类型: | String |
| 别名: | FileName, FN |
| Position: | 1 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Credential
指定有权执行此作的用户帐户。 默认值为当前用户。 这是使用 UseDefaultCredential 参数的替代方法。
键入用户名（如 User01 或 Domain01\User01），或输入 PSCredential 对象，例如由 Get-Credential cmdlet 生成的用户名。 如果键入用户名，此 cmdlet 会提示输入密码。
| 类型: | PSCredential |
| 别名: | Cred |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Namespace
指定新类的命名空间。
此参数的值与 类 参数的值一起使用，以生成类的完全限定名称。 默认值为 Microsoft.PowerShell.Commands.NewWebserviceProxy.AutogeneratedTypes 以及从 URI 生成的类型。
可以设置 Namespace 参数的值，以便可以访问具有相同名称的多个 Web 服务。
| 类型: | String |
| 别名: | NS |
| Position: | 2 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Uri
指定 Web 服务的 URI。 输入包含服务说明的文件的 URI 或路径和文件名。
URI 必须返回 .asmx 页或返回服务说明的页面。 若要返回使用 ASP.NET 创建的 Web 服务的服务说明，请追加“？WSDL“到 Web 服务的 URL（例如，http://www.contoso.com/MyWebService.asmx?WSDL）。
| 类型: | Uri |
| 别名: | WL, WSDL, Path |
| Position: | 0 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-UseDefaultCredential
指示此 cmdlet 使用默认凭据。 此 cmdlet 将生成的代理对象中的 UseDefaultCredential 属性设置为 True。 这是使用 Credential 参数的替代方法。
| 类型: | SwitchParameter |
| 别名: | UDC |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
None
不能通过管道将输入传递给此 cmdlet。
输出
A Web service proxy object
此 cmdlet 返回 Web 服务代理对象。 对象的命名空间和类由命令的参数确定。 默认值是从输入 URI 生成的。
备注
New-WebServiceProxy 使用 System.Net.WebClient 类加载指定的 Web 服务。
