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




Tabla de contenido