Aracılığıyla paylaş

New-WebServiceProxy

  • Başvuru
Modül:
Microsoft.PowerShell.Management

PowerShell'de Web hizmetini kullanmanıza ve yönetmenize olanak tanıyan bir Web hizmeti proxy nesnesi oluşturur.

Sözdizimi

New-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>]

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 Ad Alanı belirtmek için Uri parametresini ve nesnenin ad alanını ve sınıfını belirtmek için Sınıf parametrelerini kullanır.

Ö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.

Tür:String
Diğer adlar:FileName, FN
Position:1
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Credential

Bu eylemi gerçekleştirme iznine sahip bir kullanıcı hesabı belirtir. Varsayılan değer geçerli 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.

Tür:PSCredential
Diğer adlar:Cred
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:String
Diğer adlar:NS
Position:2
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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).

Tür:Uri
Diğer adlar:WL, WSDL, Path
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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.

Tür:SwitchParameter
Diğer adlar:UDC
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

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.