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.

Syntax

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

cmdlet'i New-WebServiceProxy 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 cmdlet'ini kullanır New-WebServiceProxy .

$URI = "http://www.dneonline.com/calculator.asmx?wsdl"
$calc = New-WebServiceProxy -Uri $URI -Namespace "WSProxy" -Class "Calculator"

komutu, nesnenin ad alanını ve sınıfını belirtmek için URI ve Ad Alanı ve Sınıf parametrelerini belirtmek için Uri parametresini 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, değişkende Get-Member Web hizmeti proxy nesnesinin yöntemlerini görüntülemek için cmdlet'ini $calc kullanır. Aşağıdaki örnekte bu yöntemleri kullanırız.

WebServiceProxy proxy nesnesinin TypeName değerinin ö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 örnek, değişkeninde depolanan Web hizmeti ara sunucusunu $calc kullanır. komutu, ara sunucusunun Ç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 Namespace parametresiyle birlikte kullanılır. Varsayılan değer Tekdüzen Kaynak Tanımlayıcısı'ndan (URI) oluşturulur.

Type:String
Aliases:FileName, FN
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Bu eylemi gerçekleştirme iznine sahip bir kullanıcı hesabı belirtir. Varsayılan, 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 Get-Credential oluşturulan gibi bir PSCredential nesnesi girin. Bir kullanıcı adı yazarsanız, bu cmdlet sizden parola ister.

Type:PSCredential
Aliases:Cred
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 Class 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.

Type:String
Aliases:NS
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 sayfa veya hizmet açıklaması döndüren bir sayfaya döndürmelidir .asmx . ASP.NET kullanılarak oluşturulan bir Web hizmetinin hizmet açıklamasını döndürmek için "? WSDL", Web hizmetinin URL'sine (örneğin, http://www.contoso.com/MyWebService.asmx?WSDL).

Type:Uri
Aliases:WL, WSDL, Path
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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, Credential parametresini kullanmaya alternatiftir.

Type:SwitchParameter
Aliases:UDC
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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-WebServiceProxybelirtilen Web hizmetini yüklemek için System.Net.WebClient sınıfını kullanır.