Erstellt ein Webdienstproxyobjekt, mit dem Sie den Webdienst in Windows PowerShell verwenden und verwalten können. (New-WebServiceProxy)
NAMENew-WebServiceProxyÜBERSICHTErstellt ein Webdienstproxyobjekt, mit dem Sie den Webdienst in Windows PowerShell verwenden und verwalten können.SYNTAXNew-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>]BESCHREIBUNGMit 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-Class <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 Aus URI generiert 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 [<SwitchParameter>] 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 folgende allgemeine Parameter: "Verbose", "Debug", "ErrorAction", "ErrorVariable", "WarningAction", "WarningVariable", "OutBuffer" und "OutVariable". Weitere Informationen erhalten Sie mit dem Befehl "get-help about_commonparameters".EINGABENKeiner Dieses Cmdlet nimmt keine Eingabe von der Pipeline an.AUSGABENEin 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.HINWEISENew-WebServiceProxy lädt den angegebenen Webdienst mithilfe der System.Net.WebClient-Klasse.Beispiele
BEISPIEL 1C:\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 2C:\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 3C:\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 4C:\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. VERWANDTE LINKS Online version: http://go.microsoft.com/fwlink/?LinkID=135238 (möglicherweise auf Englisch) New-Service C:\Windows>powershell get-help Get-HotFix -full
Microsoft Windows [Version 10.0.19045.3693]
Copyright (c) 2023 Microsoft Corporation.
ColorConsole [Version 3.7.1000] PowerShell 2.0-Export