Crea un objeto proxy de servicio web que permite utilizar y administrar el servicio web en Windows PowerShell.
Sintaxis
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>]
Descripción
El cmdlet New-WebServiceProxy permite utilizar un servicio web en Windows PowerShell. El cmdlet establece conexión con un servicio web y crea un objeto proxy de servicio web en Windows PowerShell. Puede utilizar el objeto proxy para administrar el servicio web.
Un servicio web es un programa basado en XML que intercambia datos a través de una red, en particular a través de Internet. Microsoft .NET Framework proporciona objetos proxy de servicio web que representan el servicio web como un objeto de .NET Framework.
Parámetros
-Class <string>
Especifica un nombre para la clase de proxy que el cmdlet crea para el servicio web. El valor de este parámetro se utiliza con el parámetro Namespace para proporcionar un nombre completo para la clase. El valor predeterminado se genera desde el URI.
|
¿Requerido? |
false |
|
¿Posición? |
2 |
|
Valor predeterminado |
Generated from the URI |
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Credential <PSCredential>
Especifica una cuenta de usuario con permiso para realizar esta acción. El valor predeterminado es el usuario actual. Esta es una alternativa al uso del parámetro UseDefaultCredential.
Escriba un nombre de usuario, como "Usuario01" o "Dominio01\Usuario01". O bien, escriba un objeto PSCredential, como uno generado por el cmdlet Get-Credential. Si escribe un nombre de usuario se le pedirá una contraseña.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-Namespace <string>
Especifica un espacio de nombres para la nueva clase.
El valor de este parámetro se utiliza con el valor del parámetro Class para generar un nombre completo para la clase. El valor predeterminado es Microsoft.PowerShell.Commands.NewWebserviceProxy.AutogeneratedTypes más un tipo que se genera desde el URI.
Puede establecer el valor del parámetro Namespace de modo que se pueda tener acceso a varios servicios web con el mismo nombre.
|
¿Requerido? |
false |
|
¿Posición? |
3 |
|
Valor predeterminado |
Microsoft.PowerShell.Commands.NewWebserviceProxy.AutogeneratedTypes |
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-URI <Uri>
Especifica el URI del servicio web. Escriba un URI o la ruta de acceso y el nombre de un archivo que contiene una descripción del servicio.
El URI debe hacer referencia a una página .asmx o a una página que devuelve una descripción del servicio. Para devolver una descripción del servicio de un servicio web creado mediante el uso de ASP.NET, anexe "?WSDL" a la dirección URL del servicio web (por ejemplo, http://www.contoso.com/MyWebService.asmx?WSDL).
|
¿Requerido? |
true |
|
¿Posición? |
1 |
|
Valor predeterminado |
|
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
-UseDefaultCredential
Establece en True el parámetro UseDefaultCredential del objeto proxy resultante. Esta es una alternativa al uso del parámetro Credential.
|
¿Requerido? |
false |
|
¿Posición? |
named |
|
Valor predeterminado |
False |
|
¿Aceptar canalización? |
false |
|
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
Entradas y salidas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
|
Entradas |
Ninguno Este cmdlet no admite entradas desde la canalización. |
|
Salidas |
A Web service proxy object El espacio de nombres y la clase del objeto los determinan los parámetros del comando. El valor predeterminado se genera desde el Identificador uniforme de recursos (URI) de entrada. |
Notas
New-WebServiceProxy utiliza la clase System.Net.WebClient para cargar el servicio web especificado.
Ejemplo 1
C:\PS>$zip = New-WebServiceProxy -uri http://www.webservicex.net/uszip.asmx?WSDL Descripción ----------- Este comando utiliza el comando New-WebServiceProxy para crear un proxy de .NET Framework del servicio web US Zip en Windows PowerShell.
Ejemplo 2
C:\PS>$URI = "http://www.webservicex.net/uszip.asmx?WSDL" C:\PS> $zip = New-WebServiceProxy -uri $URI -namespace WebServiceProxy -class ZipClass Descripción ----------- Este comando utiliza el cmdlet New-WebServiceProxy para crear un proxy de .NET Framework del servicio web US Zip. El primer comando almacena el URI del servicio web en la variable $URI. El segundo comando crea el proxy de servicio web. El comando utiliza el parámetro URI para especificar el URI y los parámetros Namespace y Class para especificar el espacio de nombres y la clase del objeto.
Ejemplo 3
C:\PS>$zip | get-member -type method TypeName: WebServiceProxy.USZip Name MemberType Definition ---- ---------- ---------- Abort Method System.Void Abort( BeginGetInfoByAreaCode Method System.IAsyncResul BeginGetInfoByCity Method System.IAsyncResul BeginGetInfoByState Method System.IAsyncResul BeginGetInfoByZIP Method System.IAsyncResul CreateObjRef Method System.Runtime.Rem Discover Method System.Void Discov Dispose Method System.Void Dispos EndGetInfoByAreaCode Method System.Xml.XmlNode EndGetInfoByCity Method System.Xml.XmlNode EndGetInfoByState Method System.Xml.XmlNode EndGetInfoByZIP Method System.Xml.XmlNode Equals Method System.Boolean Equ GetHashCode Method System.Int32 GetHa GetInfoByAreaCode Method System.Xml.XmlNode GetInfoByCity Method System.Xml.XmlNode GetInfoByState Method System.Xml.XmlNode GetInfoByZIP Method System.Xml.XmlNode GetLifetimeService Method System.Object GetL GetType Method System.Type GetTyp InitializeLifetimeService Method System.Object Init ToString Method System.String ToSt Descripción ----------- Este comando utiliza el cmdlet Get-Member para mostrar los métodos del objeto proxy de servicio web en la variable $zip. Utilizaremos estos métodos en el ejemplo siguiente. Observe que el TypeName del objeto proxy, WebServiceProxy, refleja los nombres de la clase y el espacio de nombres que se especificaron en el ejemplo anterior.
Ejemplo 4
C:\PS>$zip.getinfobyzip(20500).table CITY : Washington STATE : DC ZIP : 20500 AREA_CODE : 202 TIME_ZONE : E Descripción ----------- Este comando utiliza el proxy de servicio web almacenado en la variable Zip. El comando utiliza el método GetInfoByZip del proxy y su propiedad Table.
Vea también