New-WebServiceProxy
Crea un objeto proxy de servicio web que le permite usar y administrar el servicio web en Windows PowerShell.
Sintaxis
NoCredentials (valor predeterminado)
New-WebServiceProxy
[-Uri] <Uri>
[[-Class] <String>]
[[-Namespace] <String>]
[<CommonParameters>]
Credential
New-WebServiceProxy
[-Uri] <Uri>
[[-Class] <String>]
[[-Namespace] <String>]
[-Credential <PSCredential>]
[<CommonParameters>]
UseDefaultCredential
New-WebServiceProxy
[-Uri] <Uri>
[[-Class] <String>]
[[-Namespace] <String>]
[-UseDefaultCredential]
[<CommonParameters>]
Description
El cmdlet New-WebServiceProxy
Un servicio web es un programa basado en XML que intercambia datos a través de una red, especialmente 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.
Ejemplos
Ejemplo 1: Creación de un proxy para un servicio web
PS C:\> $zip = New-WebServiceProxy -Uri "http://www.webservicex.net/uszip.asmx?WSDL"
Este comando crea un proxy de .NET Framework del servicio web ZIP de EE. UU. en Windows PowerShell.
Ejemplo 2: Crear un proxy para un servicio web y especificar el espacio de nombres y la clase
PS C:\> $URI = "http://www.webservicex.net/uszip.asmx?WSDL"
PS C:\> $zip = New-WebServiceProxy -Uri $URI -Namespace "WebServiceProxy" -Class "USZip"
Este comando usa el cmdlet New-WebServiceProxy para crear un proxy de .NET Framework del servicio web ZIP de EE. UU.
El primer comando almacena el URI del servicio web en la variable $URI.
El segundo comando crea el proxy del servicio web.
El comando usa el parámetro URI de
Ejemplo 3: Mostrar métodos de un proxy de servicio web
PS C:\> $zip | Get-Member -MemberType 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
Este comando usa el cmdlet Get-Member para mostrar los métodos del objeto proxy de servicio web en la variable $zip. Usaremos estos métodos en el ejemplo siguiente.
Observe que el TypeName del objeto proxy, WebServiceProxy, refleja los nombres de clase y espacio de nombres especificados en el ejemplo anterior.
Ejemplo 4: Uso de un proxy de servicio web
PS C:\> $zip.GetInfoByZip(20500).table
CITY : Washington
STATE : DC
ZIP : 20500
AREA_CODE : 202
TIME_ZONE : E
Este comando usa el proxy de servicio web almacenado en la variable $zip. El comando usa el método GetInfoByZip del proxy y su propiedad Table.
Parámetros
-Class
Especifica un nombre para la clase de proxy que crea el cmdlet para el servicio web. El valor de este parámetro se usa junto con el parámetro Namespace para proporcionar un nombre completo para la clase . El valor predeterminado se genera a partir del identificador uniforme de recursos (URI).
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | NombreDeArchivo, FN |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Credential
Especifica una cuenta de usuario que tiene permiso para realizar esta acción.
El valor predeterminado es el usuario actual.
Se trata de una alternativa al uso del parámetro
Escriba un nombre de usuario, como User01 o Domain01\User01, o escriba un objeto de PSCredential, como uno generado por el cmdlet Get-Credential. Si escribe un nombre de usuario, este cmdlet le pedirá una contraseña.
Propiedades de parámetro
| Tipo: | PSCredential |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Cred |
Conjuntos de parámetros
Credential
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Namespace
Especifica un espacio de nombres para la nueva clase.
El valor de este parámetro se usa junto 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 a partir del URI.
Puede establecer el valor del parámetro Namespace para que pueda acceder a varios servicios web que tengan el mismo nombre.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | NS |
Conjuntos de parámetros
(All)
| Posición: | 2 |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Uri
Especifica el URI del servicio web. Escriba un URI o la ruta de acceso y el nombre de archivo de un archivo que contenga una descripción del servicio.
El URI debe hacer referencia a una página .asmx o a una página que devuelva una descripción del servicio.
Para devolver una descripción del servicio de un servicio web que se creó mediante ASP.NET, anexe "? WSDL" a la dirección URL del servicio web (por ejemplo, https://www.contoso.com/MyWebService.asmx?WSDL).
Propiedades de parámetro
| Tipo: | Uri |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | WL, WSDL, Ruta |
Conjuntos de parámetros
(All)
| Posición: | 0 |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-UseDefaultCredential
Indica que este cmdlet usa la credencial predeterminada.
Este cmdlet establece la propiedad UseDefaultCredential en el objeto proxy resultante en True.
Se trata de una alternativa al uso del parámetro credential
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | UDC |
Conjuntos de parámetros
UseDefaultCredential
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
Entradas
None
No se puede canalizar la entrada a este cmdlet.
Salidas
A Web service proxy object
Este cmdlet devuelve un objeto proxy de servicio web. Los parámetros del comando determinan el espacio de nombres y la clase del objeto. El valor predeterminado se genera a partir del URI de entrada.
Notas
New-WebServiceProxy usa la clase System.Net.WebClient para cargar el servicio web especificado.