New-WebServiceProxy

  • Referensi
Modul:
Microsoft.PowerShell.Management

Membuat objek proksi layanan Web yang memungkinkan Anda menggunakan dan mengelola layanan Web di PowerShell.

Sintaks

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

Deskripsi

New-WebServiceProxy Cmdlet memungkinkan Anda menggunakan layanan Web di PowerShell. Cmdlet tersambung ke layanan Web dan membuat objek proksi layanan Web di PowerShell. Anda dapat menggunakan objek proksi untuk mengelola layanan Web.

Layanan Web adalah program berbasis XML yang bertukar data melalui jaringan, terutama melalui Internet. Microsoft .NET Framework menyediakan objek proksi layanan Web yang mewakili layanan Web sebagai objek .NET Framework.

Contoh

Contoh 1: Membuat proksi untuk layanan Web

Contoh ini membuat proksi .NET Framework dari layanan Web kalkulator di Windows PowerShell.

$calc = New-WebServiceProxy -Uri "http://www.dneonline.com/calculator.asmx?wsdl"

Contoh 2: Membuat proksi untuk layanan Web dan menentukan namespace dan kelas

Contoh ini menggunakan New-WebServiceProxy cmdlet untuk membuat proksi .NET Framework dari layanan Web kalkulator.

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

Perintah menggunakan parameter Uri untuk menentukan parameter URI dan Namespace dan Class untuk menentukan namespace dan kelas objek.

Contoh 3: Menampilkan metode proksi layanan Web

$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()

Contoh ini menggunakan Get-Member cmdlet untuk menampilkan metode objek proksi layanan Web dalam $calc variabel. Kami menggunakan metode ini dalam contoh berikut.

Perhatikan bahwa TypeName objek proksi, WebServiceProxy, mencerminkan namespace layanan dan nama kelas yang ditentukan dalam contoh sebelumnya.

Contoh 4: Menggunakan proksi layanan Web

PS> $calc.Multiply(6,7)
42

Contoh ini menggunakan proksi layanan Web yang disimpan dalam $calc variabel. Perintah menggunakan metode Perkalian proksi.

Parameter

-Class

Menentukan nama untuk kelas proksi yang dibuat cmdlet untuk layanan Web. Nilai parameter ini digunakan bersama dengan parameter Namespace untuk memberikan nama yang sepenuhnya memenuhi syarat untuk kelas. Nilai default dihasilkan dari Pengidentifikasi Sumber Daya Seragam (URI).

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

-Credential

Menentukan akun pengguna yang memiliki izin untuk melakukan tindakan ini. Defaultnya adalah pengguna saat ini. Ini adalah alternatif untuk menggunakan parameter UseDefaultCredential .

Ketik nama pengguna, seperti User01 atau Domain01\User01, atau masukkan objek PSCredential , seperti yang dihasilkan oleh Get-Credential cmdlet. Jika Anda mengetik nama pengguna, cmdlet ini akan meminta kata sandi kepada Anda.

Type:PSCredential
Aliases:Cred
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Namespace

Menentukan namespace layanan untuk kelas baru.

Nilai parameter ini digunakan bersama dengan nilai parameter Kelas untuk menghasilkan nama yang sepenuhnya memenuhi syarat untuk kelas. Nilai defaultnya adalah Microsoft.PowerShell.Commands.NewWebserviceProxy.AutogeneratedTypes ditambah jenis yang dihasilkan dari URI.

Anda dapat mengatur nilai parameter Namespace sehingga Anda dapat mengakses beberapa layanan Web yang memiliki nama yang sama.

Type:String
Aliases:NS
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Uri

Menentukan URI layanan Web. Masukkan URI atau jalur dan nama file file yang berisi deskripsi layanan.

URI harus mengembalikan .asmx halaman atau ke halaman yang mengembalikan deskripsi layanan. Untuk mengembalikan deskripsi layanan dari layanan Web yang dibuat menggunakan ASP.NET, tambahkan "? WSDL" ke URL layanan Web (misalnya, 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

Menunjukkan bahwa cmdlet ini menggunakan kredensial default. Cmdlet ini mengatur properti UseDefaultCredential dalam objek proksi yang dihasilkan ke True. Ini adalah alternatif untuk menggunakan parameter Kredensial .

Type:SwitchParameter
Aliases:UDC
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

None

Anda tidak dapat menyalurkan input ke cmdlet ini.

Output

A Web service proxy object

Cmdlet ini mengembalikan objek proksi layanan Web. Namespace dan kelas objek ditentukan oleh parameter perintah. Default dihasilkan dari URI input.

Catatan

New-WebServiceProxymenggunakan kelas System.Net.WebClient untuk memuat layanan Web yang ditentukan.