New-WebServiceProxy
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, https://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.