Erstellt ein Webdienstproxyobjekt, mit dem Sie den Webdienst in Windows PowerShell verwenden und verwalten können.

Syntax

New-WebServiceProxy [-URI] <Uri> [[-Klasse] <string>] [[-Namespace] <string>] [<CommonParameters>]

New-WebServiceProxy [-URI] <Uri> [[-Klasse] <string>] [[-Namespace] <string>] [-Credential <PSCredential>] [<CommonParameters>]

New-WebServiceProxy [-URI] <Uri> [[-Klasse] <string>] [[-Namespace] <string>] [-UseDefaultCredential] [<CommonParameters>]

Beschreibung

Mit dem Cmdlet "New-WebServiceProxy" können Sie einen Webdienst in Windows PowerShell verwenden. Das Cmdlet stellt eine Verbindung mit einem Webdienst her und erstellt ein Webdienstproxyobjekt in Windows PowerShell. Sie können den Webdienst mithilfe des Proxyobjekts verwalten.

Bei einem Webdienst handelt es sich um ein XML-basiertes Programm, das Daten über ein Netzwerk austauscht, insbesondere über das Internet. Microsoft .NET Framework stellt Webdienstproxyobjekte bereit, die den Webdienst als .NET Framework-Objekt darstellen.

Parameter

-Klasse <string>

Gibt einen Namen für die Proxyklasse an, die das Cmdlet für den Webdienst erstellt. Der Wert dieses Parameters wird mit dem Namespace-Parameter verwendet, um einen vollqualifizierten Namen für die Klasse bereitzustellen. Der Standardwert wird aus dem URI generiert.

Erforderlich?

false

Position?

2

Standardwert

Generated from the URI

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Credential <PSCredential>

Gibt ein Benutzerkonto an, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Der Standardwert ist der aktuelle Benutzer. Dies stellt eine Alternative zum Verwenden des UseDefaultCredential-Parameters dar.

Geben Sie einen Benutzernamen ein, z. B. "User01" oder "Domain01\User01". Oder geben Sie ein PSCredential-Objekt ein, z. B. ein vom Cmdlet "Get-Credential" generiertes Objekt. Wenn Sie einen Benutzernamen eingeben, werden Sie zur Eingabe eines Kennworts aufgefordert.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Namespace <string>

Gibt einen Namespace für die neue Klasse an.

Der Wert dieses Parameters wird mit dem Wert des Class-Parameters verwendet, um einen vollqualifizierten Namen für die Klasse zu generieren. Der Standardwert lautet "Microsoft.PowerShell.Commands.NewWebserviceProxy.AutogeneratedTypes" mit einem Typ, der aus dem URI generiert wird.

Sie können den Wert des Namespace-Parameters festlegen, damit Sie auf mehrere Webdienste mit dem gleichen Namen zugreifen können.

Erforderlich?

false

Position?

3

Standardwert

Microsoft.PowerShell.Commands.NewWebserviceProxy.AutogeneratedTypes

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-URI <Uri>

Gibt den URI des Webdiensts an. Geben Sie einen URI oder den Pfad und Dateinamen einer Datei ein, die eine Dienstbeschreibung enthält.

Der URI muss auf eine ASMX-Seite oder auf eine Seite verweisen, die eine Dienstbeschreibung zurückgibt. Wenn eine Dienstbeschreibung für einen Webdienst zurückgegeben werden soll, der mit ASP.NET erstellt wurde, fügen Sie "?WSDL" an die URL des Webdiensts an (z. B. "http://www.contoso.com/MyWebService.asmx?WSDL").

Erforderlich?

true

Position?

1

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-UseDefaultCredential

Legt den UseDefaultCredential-Parameter im resultierenden Proxyobjekt auf "True" fest. Dies stellt eine Alternative zum Verwenden des Credential-Parameters dar.

Erforderlich?

false

Position?

named

Standardwert

False

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

<CommonParameters>

Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.

Eingaben und Ausgaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.

Eingaben

None

Dieses Cmdlet nimmt keine Eingabe von der Pipeline an.

Ausgaben

Ein Webdienstproxyobjekt

Der Namespace und die Klasse des Objekts werden von den Parametern des Befehls bestimmt. Der Standardwert wird vom Eingabe-URI (Uniform Resource Identifier) generiert.

Hinweise

New-WebServiceProxy lädt den angegebenen Webdienst mithilfe der System.Net.WebClient-Klasse.

Beispiel 1

C:\PS>$zip = New-WebServiceProxy -uri http://www.webservicex.net/uszip.asmx?WSDL

Beschreibung
-----------
Dieser Befehl erstellt mit dem Befehl "New-WebServiceProxy" einen .NET Framework-Proxy des Webdiensts "US Zip" in Windows PowerShell.






Beispiel 2

C:\PS>$URI = "http://www.webservicex.net/uszip.asmx?WSDL" 

C:\PS> $zip = New-WebServiceProxy -uri $URI -namespace WebServiceProxy -class ZipClass

Beschreibung
-----------
Dieser Befehl erstellt mit dem Cmdlet "New-WebServiceProxy" einen .NET Framework-Proxy des Webdiensts "US Zip".

Mit dem ersten Befehl wird der URI des Webdiensts in der Variablen "$URI" gespeichert.

Mit dem zweiten Befehl wird der Webdienstproxy erstellt. Im Befehl wird mit dem URI-Parameter der URI angegeben. Der Namespace-Parameter und der Class-Parameter geben den Namespace und die Klasse des Objekts an.






Beispiel 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

Beschreibung
-----------
In diesem Befehl werden mit dem Cmdlet "Get-Member" die Methoden des Webdienstproxyobjekts in der Variablen "$zip" angezeigt. Diese Methoden werden im folgenden Beispiel verwendet.

Beachten Sie, dass der TypeName für das Proxyobjekt, WebServiceProxy, den Namespace und die Klassennamen angibt, die im vorherigen Beispiel angegeben wurden.






Beispiel 4

C:\PS>$zip.getinfobyzip(20500).table

CITY      : Washington
STATE     : DC
ZIP       : 20500
AREA_CODE : 202
TIME_ZONE : E

Beschreibung
-----------
In diesem Befehl wird der in der Variablen "Zip" gespeicherte Webdienstproxy verwendet. Der Befehl verwendet die GetInfoByZip-Methode des Proxys sowie die Table-Eigenschaft.






Siehe auch




Inhaltsverzeichnis