New-WebServiceProxy
PowerShell'de Web hizmetini kullanmanıza ve yönetmenize olanak tanıyan bir Web hizmeti proxy nesnesi oluşturur.
Syntax
NoCredentials (Varsayılan)
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
New-WebServiceProxy cmdlet'i PowerShell'de bir Web hizmeti kullanmanıza olanak tanır. Cmdlet bir Web hizmetine bağlanır ve PowerShell'de bir Web hizmeti proxy nesnesi oluşturur. Web hizmetini yönetmek için proxy nesnesini kullanabilirsiniz.
Web hizmeti, özellikle İnternet üzerinden bir ağ üzerinden veri alışverişinde bulunan XML tabanlı bir programdır. Microsoft .NET Framework, Web hizmetini .NET Framework nesnesi olarak temsil eden Web hizmeti proxy nesneleri sağlar.
Örnekler
Örnek 1: Web hizmeti için ara sunucu oluşturma
Bu örnek, Windows PowerShell'de hesap makinesi Web hizmetinin .NET Framework proxy'sini oluşturur.
$calc = New-WebServiceProxy -Uri "http://www.dneonline.com/calculator.asmx?wsdl"
Örnek 2: Web hizmeti için ara sunucu oluşturma ve ad alanı ile sınıfı belirtme
Bu örnek, hesap makinesi Web hizmetinin .NET Framework ara sunucusunu oluşturmak için New-WebServiceProxy cmdlet'ini kullanır.
$URI = "http://www.dneonline.com/calculator.asmx?wsdl"
$calc = New-WebServiceProxy -Uri $URI -Namespace "WSProxy" -Class "Calculator"
komut, URI ve
Örnek 3: Web hizmeti ara sunucusunun görüntüleme yöntemleri
$calc | Get-Member -MemberType Method
TypeName: WSProxy.Calculator
Name MemberType Definition
---- ---------- ----------
Abort Method void Abort()
Add Method int Add(int intA, int intB)
AddAsync Method void AddAsync(int intA, int intB), void AddAsync(int intA,
BeginAdd Method System.IAsyncResult BeginAdd(int intA, int intB, System.Asy
BeginDivide Method System.IAsyncResult BeginDivide(int intA, int intB, System.
BeginMultiply Method System.IAsyncResult BeginMultiply(int intA, int intB, Syste
BeginSubtract Method System.IAsyncResult BeginSubtract(int intA, int intB, Syste
CancelAsync Method void CancelAsync(System.Object userState)
CreateObjRef Method System.Runtime.Remoting.ObjRef CreateObjRef(type requestedT
Discover Method void Discover()
Dispose Method void Dispose(), void IDisposable.Dispose()
Divide Method int Divide(int intA, int intB)
DivideAsync Method void DivideAsync(int intA, int intB), void DivideAsync(int
EndAdd Method int EndAdd(System.IAsyncResult asyncResult)
EndDivide Method int EndDivide(System.IAsyncResult asyncResult)
EndMultiply Method int EndMultiply(System.IAsyncResult asyncResult)
EndSubtract Method int EndSubtract(System.IAsyncResult asyncResult)
Equals Method bool Equals(System.Object obj)
GetHashCode Method int GetHashCode()
GetLifetimeService Method System.Object GetLifetimeService()
GetType Method type GetType()
InitializeLifetimeService Method System.Object InitializeLifetimeService()
Multiply Method int Multiply(int intA, int intB)
MultiplyAsync Method void MultiplyAsync(int intA, int intB), void MultiplyAsync(
Subtract Method int Subtract(int intA, int intB)
SubtractAsync Method void SubtractAsync(int intA, int intB), void SubtractAsync(
ToString Method string ToString()
Bu örnek, Get-Member değişkeninde Web hizmeti proxy nesnesinin yöntemlerini görüntülemek için $calc cmdlet'ini kullanır. Aşağıdaki örnekte bu yöntemleri kullanırız.
WebServiceProxy proxy nesnesinin TypeName önceki örnekte belirtilen ad alanını ve sınıf adlarını yansıttığını görebilirsiniz.
Örnek 4: Web hizmeti ara sunucusu kullanma
PS> $calc.Multiply(6,7)
42
Bu örnekte, $calc değişkeninde depolanan Web hizmeti proxy'si kullanılır. komut, proxy'nin Çarpma yöntemini kullanır.
Parametreler
-Class
Cmdlet'in Web hizmeti için oluşturduğu ara sunucu sınıfı için bir ad belirtir. Bu parametrenin değeri, sınıfı için tam bir ad sağlamak üzere Ad Alanı parametresiyle birlikte kullanılır. Varsayılan değer Tekdüzen Kaynak Tanımlayıcısı'ndan (URI) oluşturulur.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | DosyaAdı, FN |
Parametre kümeleri
(All)
| Position: | 1 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Credential
Bu eylemi gerçekleştirme iznine sahip bir kullanıcı hesabı belirtir. Varsayılan değer mevcut kullanıcıdır. Bu, UseDefaultCredential parametresini kullanmaya alternatiftir.
User01 veya Domain01\User01 gibi bir kullanıcı adı yazın veya cmdlet'i tarafından oluşturulan nesne gibi Get-Credential nesnesi girin. Bir kullanıcı adı yazarsanız, bu cmdlet sizden parola ister.
Parametre özellikleri
| Tür: | PSCredential |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Cred |
Parametre kümeleri
Credential
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Namespace
Yeni sınıf için bir ad alanı belirtir.
Bu parametrenin değeri, sınıf için tam bir ad oluşturmak üzere Sınıfı parametresinin değeriyle birlikte kullanılır. Varsayılan değer Microsoft.PowerShell.Commands.NewWebserviceProxy.AutogeneratedTypes ve URI'den oluşturulan bir türdür.
Ad Alanı parametresinin değerini ayarlayarak aynı ada sahip birden çok Web hizmetlerine erişebilirsiniz.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | NS |
Parametre kümeleri
(All)
| Position: | 2 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Uri
Web hizmetinin URI'sini belirtir. Hizmet açıklaması içeren bir dosyanın URI'sini veya yolunu ve dosya adını girin.
URI bir .asmx sayfası veya hizmet açıklaması döndüren bir sayfaya döndürmelidir. ASP.NET kullanılarak oluşturulan bir Web hizmetinin hizmet açıklamasını döndürmek için "? Web hizmetinin URL'sine WSDL" (örneğin, http://www.contoso.com/MyWebService.asmx?WSDL).
Parametre özellikleri
| Tür: | Uri |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | WL, WSDL, Yol |
Parametre kümeleri
(All)
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-UseDefaultCredential
Bu cmdlet'in varsayılan kimlik bilgilerini kullandığını gösterir. Bu cmdlet, sonuçta elde edilen proxy nesnesindeki UseDefaultCredential özelliğini True olarak ayarlar. Bu, Kimlik Bilgisi parametresini kullanmaya alternatiftir.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | UDC |
Parametre kümeleri
UseDefaultCredential
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
Girişler
None
Bu cmdlet'e giriş kanalı yapamazsınız.
Çıkışlar
A Web service proxy object
Bu cmdlet bir Web hizmeti proxy nesnesi döndürür. nesnesinin ad alanı ve sınıfı, komutun parametreleri tarafından belirlenir. Varsayılan değer giriş URI'sinden oluşturulur.
Notlar
New-WebServiceProxy, belirtilen Web hizmetini yüklemek için System.Net.WebClient sınıfını kullanır.
