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