New-WebServiceProxy
Létrehoz egy webszolgáltatás-proxyobjektumot, amely lehetővé teszi a webszolgáltatás használatát és kezelését a Windows PowerShellben.
Syntax
NoCredentials (Alapértelmezett)
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
A New-WebServiceProxy parancsmaggal webszolgáltatást használhat a Windows PowerShellben. A parancsmag egy webszolgáltatáshoz csatlakozik, és létrehoz egy webszolgáltatás-proxyobjektumot a Windows PowerShellben. A proxyobjektum használatával kezelheti a webszolgáltatást.
A webszolgáltatás egy XML-alapú program, amely adatokat cserél egy hálózaton keresztül, különösen az interneten keresztül. A Microsoft .NET-keretrendszer olyan webszolgáltatás-proxyobjektumokat biztosít, amelyek a webszolgáltatást .NET-keretrendszer-objektumként jelölik.
Példák
1. példa: Proxy létrehozása webszolgáltatáshoz
PS C:\> $zip = New-WebServiceProxy -Uri "http://www.webservicex.net/uszip.asmx?WSDL"
Ez a parancs létrehoz egy .NET-keretrendszerproxyt az US Zip Web service-ből a Windows PowerShellben.
2. példa: Proxy létrehozása webszolgáltatáshoz, névtér és osztály megadása
PS C:\> $URI = "http://www.webservicex.net/uszip.asmx?WSDL"
PS C:\> $zip = New-WebServiceProxy -Uri $URI -Namespace "WebServiceProxy" -Class "USZip"
Ez a parancs a New-WebServiceProxy parancsmaggal hozza létre az USA Zip Web service .NET-keretrendszerproxyját.
Az első parancs a webszolgáltatás URI-ját a $URI változóban tárolja.
A második parancs létrehozza a webszolgáltatás-proxyt. A parancs az Uri paramétert használja az URI és a Névtér és Osztály paraméterek megadásához az objektum névterének és osztályának megadásához.
3. példa: Webszolgáltatás-proxy megjelenítési módszerei
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
Ez a parancs a Get-Member parancsmaggal jeleníti meg a webszolgáltatás-proxyobjektum metódusait a $zip változóban. Ezeket a metódusokat a következő példában fogjuk használni.
Figyelje meg, hogy a WebServiceProxy proxyobjektum TypeName az előző példában megadott névteret és osztályneveket tükrözi.
4. példa: Webszolgáltatás-proxy használata
PS C:\> $zip.GetInfoByZip(20500).table
CITY : Washington
STATE : DC
ZIP : 20500
AREA_CODE : 202
TIME_ZONE : E
Ez a parancs a $zip változóban tárolt webszolgáltatás-proxyt használja. A parancs a proxy és a Table tulajdonság GetInfoByZip metódusát használja.
Paraméterek
-Class
Megadja annak a proxyosztálynak a nevét, amelyet a parancsmag létrehoz a webszolgáltatás számára. Ennek a paraméternek az értéke a Névtér paraméterrel együtt használatos az osztály teljes névvédelméhez. Az alapértelmezett érték az egységes erőforrás-azonosítóból (URI) jön létre.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | fájlnév, FN |
Paraméterkészletek
(All)
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Credential
A művelet végrehajtásához engedéllyel rendelkező felhasználói fiókot ad meg. Az alapértelmezett az aktuális felhasználó. Ez egy alternatíva a UseDefaultCredential paraméter használatára.
Írjon be egy felhasználónevet (például User01 vagy Domain01\User01), vagy írjon be egy PSCredential objektumot, például a Get-Credential parancsmag által létrehozott objektumot. Ha felhasználónevet ír be, ez a parancsmag jelszó megadását kéri.
Paramétertulajdonságok
| Típus: | PSCredential |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cred |
Paraméterkészletek
Credential
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Namespace
Megadja az új osztály névterét.
Ennek a paraméternek az értékét a osztály paraméter értékével együtt használja a rendszer az osztály teljes minősített nevének létrehozásához. Az alapértelmezett érték a Microsoft.PowerShell.Commands.NewWebserviceProxy.AutogeneratedTypes, valamint az URI-ból létrehozott típus.
Beállíthatja a névtér paraméter értékét, hogy több azonos nevű webszolgáltatáshoz is hozzáférhessen.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | NS |
Paraméterkészletek
(All)
| Position: | 2 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Uri
A webszolgáltatás URI-ját adja meg. Adjon meg egy URI-t vagy egy szolgáltatásleírást tartalmazó fájl elérési útját és fájlnevét.
Az URI-nak egy .asmx lapra vagy egy szolgáltatásleírást visszaíró lapra kell hivatkoznia.
Ha egy ASP.NET használatával létrehozott webszolgáltatás szolgáltatásleírását szeretné visszaadni, fűzze hozzá a következőt: "? WSDL" a webszolgáltatás URL-címére (például https://www.contoso.com/MyWebService.asmx?WSDL).
Paramétertulajdonságok
| Típus: | Uri |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | WL, WSDL, Útvonal |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-UseDefaultCredential
Azt jelzi, hogy ez a parancsmag az alapértelmezett hitelesítő adatot használja. Ez a parancsmag az eredményül kapott proxyobjektum UseDefaultCredential tulajdonságát True értékre állítja. Ez egy alternatíva a Hitelesítő adatok paraméter használatára.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | UDC |
Paraméterkészletek
UseDefaultCredential
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
None
Ehhez a parancsmaghoz nem csövezhet be bemenetet.
Kimenetek
A Web service proxy object
Ez a parancsmag egy webszolgáltatás-proxyobjektumot ad vissza. Az objektum névterét és osztályát a parancs paraméterei határozzák meg. Az alapértelmezett érték a bemeneti URI-ból jön létre.
Jegyzetek
New-WebServiceProxy a System.Net.WebClient osztályt használja a megadott webszolgáltatás betöltéséhez.