New-WebServiceProxy
Tworzy obiekt serwera proxy usługi sieci Web, który umożliwia korzystanie z usługi sieci Web i zarządzanie nią w programie Windows PowerShell.
Składnia
NoCredentials (domyślnie)
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>]
Opis
Polecenie cmdlet New-WebServiceProxy umożliwia korzystanie z usługi internetowej w programie Windows PowerShell. Polecenie cmdlet łączy się z usługą sieci Web i tworzy obiekt serwera proxy usługi sieci Web w programie Windows PowerShell. Obiekt proxy służy do zarządzania usługą sieci Web.
Usługa sieci Web to program oparty na formacie XML, który wymienia dane za pośrednictwem sieci, zwłaszcza przez Internet. Program Microsoft .NET Framework udostępnia obiekty serwera proxy usługi sieci Web reprezentujące usługę internetową jako obiekt programu .NET Framework.
Przykłady
Przykład 1. Tworzenie serwera proxy dla usługi sieci Web
PS C:\> $zip = New-WebServiceProxy -Uri "http://www.webservicex.net/uszip.asmx?WSDL"
To polecenie tworzy serwer proxy programu .NET Framework amerykańskiej usługi internetowej zip w programie Windows PowerShell.
Przykład 2. Tworzenie serwera proxy dla usługi sieci Web i określanie przestrzeni nazw i klasy
PS C:\> $URI = "http://www.webservicex.net/uszip.asmx?WSDL"
PS C:\> $zip = New-WebServiceProxy -Uri $URI -Namespace "WebServiceProxy" -Class "USZip"
To polecenie używa polecenia cmdlet New-WebServiceProxy, aby utworzyć serwer proxy programu .NET Framework usługi internetowej zip w STANACH Zjednoczonych.
Pierwsze polecenie przechowuje identyfikator URI usługi sieci Web w zmiennej $URI.
Drugie polecenie tworzy serwer proxy usługi sieci Web.
Polecenie używa parametru identyfikatora Uri
Przykład 3. Wyświetlanie metod serwera proxy usługi sieci 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
To polecenie używa polecenia cmdlet Get-Member do wyświetlania metod obiektu serwera proxy usługi sieci Web w zmiennej $zip. Użyjemy tych metod w poniższym przykładzie.
Zwróć uwagę, że TypeName obiektu proxy WebServiceProxy odzwierciedla przestrzeń nazw i nazwy klas, które zostały określone w poprzednim przykładzie.
Przykład 4. Używanie serwera proxy usługi sieci Web
PS C:\> $zip.GetInfoByZip(20500).table
CITY : Washington
STATE : DC
ZIP : 20500
AREA_CODE : 202
TIME_ZONE : E
To polecenie używa serwera proxy usługi sieci Web przechowywanego w zmiennej $zip. Polecenie używa metody GetInfoByZip serwera proxy i jej właściwości Table.
Parametry
-Class
Określa nazwę klasy serwera proxy, którą polecenie cmdlet tworzy dla usługi sieci Web. Wartość tego parametru jest używana razem z parametrem Przestrzeni nazw, aby podać w pełni kwalifikowaną nazwę klasy. Wartość domyślna jest generowana na podstawie identyfikatora URI (Uniform Resource Identifier).
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | NazwaPliku, FN |
Zestawy parametrów
(All)
| Position: | 1 |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Credential
Określa konto użytkownika, które ma uprawnienia do wykonania tej akcji. Wartość domyślna to bieżący użytkownik. Jest to alternatywa dla używania parametru UseDefaultCredential.
Wpisz nazwę użytkownika, taką jak User01 lub Domain01\User01, lub wprowadź obiekt PSCredential, taki jak jeden wygenerowany przez polecenie cmdlet Get-Credential. Jeśli wpiszesz nazwę użytkownika, to polecenie cmdlet wyświetli monit o podanie hasła.
Właściwości parametru
| Typ: | PSCredential |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Cred |
Zestawy parametrów
Credential
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Namespace
Określa przestrzeń nazw dla nowej klasy.
Wartość tego parametru jest używana razem z wartością parametru Class w celu wygenerowania w pełni kwalifikowanej nazwy klasy. Wartość domyślna to Microsoft.PowerShell.Commands.NewWebserviceProxy.AutogeneratedTypes oraz typ wygenerowany na podstawie identyfikatora URI.
Możesz ustawić wartość parametru Przestrzeni nazw, aby uzyskać dostęp do wielu usług sieci Web o tej samej nazwie.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | NS |
Zestawy parametrów
(All)
| Position: | 2 |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Uri
Określa identyfikator URI usługi sieci Web. Wprowadź identyfikator URI lub ścieżkę i nazwę pliku, który zawiera opis usługi.
Identyfikator URI musi odwoływać się do strony asmx lub do strony zwracającej opis usługi.
Aby zwrócić opis usługi sieci Web, która została utworzona przy użyciu ASP.NET, dołącz "? WSDL" do adresu URL usługi sieci Web (na przykład https://www.contoso.com/MyWebService.asmx?WSDL).
Właściwości parametru
| Typ: | Uri |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | WL, WSDL, Ścieżka |
Zestawy parametrów
(All)
| Position: | 0 |
| Obowiązkowe: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-UseDefaultCredential
Wskazuje, że to polecenie cmdlet używa poświadczeń domyślnych.
To polecenie cmdlet ustawia właściwość UseDefaultCredential w wynikowym obiekcie serwera proxy na true.
Jest to alternatywa dla używania parametru credential
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | UDC |
Zestawy parametrów
UseDefaultCredential
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Dane wejściowe
None
Nie można przekazać danych wejściowych potoku do tego polecenia cmdlet.
Dane wyjściowe
A Web service proxy object
To polecenie cmdlet zwraca obiekt serwera proxy usługi sieci Web. Przestrzeń nazw i klasa obiektu są określane przez parametry polecenia. Wartość domyślna jest generowana na podstawie identyfikatora URI wejściowego.
Uwagi
New-WebServiceProxy używa klasy System.Net.WebClient w celu załadowania określonej usługi sieci Web.