New-WebServiceProxy

아티클
01/12/2010

Windows PowerShell에서 웹 서비스를 사용하고 관리하는 데 필요한 웹 서비스 프록시 개체를 만듭니다.

구문

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

설명

New-WebServiceProxy cmdlet을 사용하면 Windows PowerShell에서 웹 서비스를 사용할 수 있습니다. 이 cmdlet은 웹 서비스에 연결하여 Windows PowerShell에 웹 서비스 프록시 개체를 만듭니다. 프록시 개체를 사용하여 웹 서비스를 관리할 수 있습니다.

웹 서비스는 네트워크, 특히 인터넷을 통해 데이터를 교환하는 XML 기반 프로그램입니다. Microsoft .NET Framework는 웹 서비스를 .NET Framework 개체로 나타내는 웹 서비스 프록시 개체를 제공합니다.

매개 변수

-Class <string>

cmdlet이 웹 서비스에 대해 만드는 프록시 클래스의 이름을 지정합니다. 이 매개 변수 값은 Namespace 매개 변수 값에 사용되어 클래스의 정규화된 이름을 제공합니다. 기본값은 URI에서 생성됩니다.

필수 여부	false
위치	2
기본값	URI에서 생성됨
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-Credential <PSCredential>

이 작업을 수행할 수 있는 권한을 가진 사용자 계정을 지정합니다. 기본값은 현재 사용자입니다. UseDefaultCredential 매개 변수 대신 사용할 수 있습니다.

"User01" 또는 "Domain01\User01"과 같은 사용자 이름을 입력합니다. 또는 Get-Credential cmdlet에 의해 생성된 개체와 같은 PSCredential 개체를 입력합니다. 사용자 이름을 입력하면 암호를 묻는 메시지가 표시됩니다.

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-Namespace <string>

새 클래스의 네임스페이스를 지정합니다.

이 매개 변수 값은 Class 매개 변수 값에 사용되어 클래스의 정규화된 이름을 생성합니다. 기본값은 Microsoft.PowerShell.Commands.NewWebserviceProxy.AutogeneratedTypes + URI에서 생성된 유형입니다.

Namespace 매개 변수 값을 설정하여 동일한 이름의 여러 웹 서비스에 액세스할 수 있습니다.

필수 여부	false
위치	3
기본값	Microsoft.PowerShell.Commands.NewWebserviceProxy.AutogeneratedTypes
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-URI <Uri>

웹 서비스의 URI를 지정합니다. 서비스 설명이 포함된 파일의 경로 및 파일 이름 또는 URI를 입력합니다.

URI는 .asmx 페이지나 서비스 설명을 반환하는 페이지를 참조해야 합니다. ASP.NET을 사용하여 만든 웹 서비스에 대한 서비스 설명을 반환하려면 웹 서비스 URL에 "?WSDL"을 추가합니다(예: https://www.contoso.com/MyWebService.asmx?WSDL).

필수 여부	true
위치	1
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-UseDefaultCredential

결과로 생성된 프록시 개체의 UseDefaultCredential 매개 변수를 True로 설정합니다. Credential 매개 변수 대신 사용할 수 있습니다.

필수 여부	false
위치	named
기본값	False
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_commonparameters.

입력 및 출력

입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

없음

이 cmdlet은 파이프라인에서 입력을 가져오지 않습니다.

출력

웹 서비스 프록시 개체

개체의 네임스페이스 및 클래스는 명령의 매개 변수에 의해 결정됩니다. 기본값은 입력 URI(Uniform Resource Identifier)에서 생성됩니다.

참고

New-WebServiceProxy는 System.Net.WebClient 클래스를 사용하여 지정된 웹 서비스를 로드합니다.

예 1

C:\PS>$zip = New-WebServiceProxy -uri http://www.webservicex.net/uszip.asmx?WSDL

설명
-----------
이 명령은 New-WebServiceProxy 명령을 사용하여 Windows PowerShell에 미국 우편 번호 웹 서비스의 .NET Framework 프록시를 만듭니다.

예 2

C:\PS>$URI = "http://www.webservicex.net/uszip.asmx?WSDL" 

C:\PS> $zip = New-WebServiceProxy -uri $URI -namespace WebServiceProxy -class ZipClass

설명
-----------
이 명령은 New-WebServiceProxy cmdlet을 사용하여 미국 우편 번호 웹 서비스의 .NET Framework 프록시를 만듭니다.

첫 번째 명령은 웹 서비스 URI를 $URI 변수에 저장합니다.

두 번째 명령은 웹 서비스 프록시를 만듭니다. 이 명령은 URI 매개 변수를 사용하여 URI를 지정하고 Namespace 및 Class 매개 변수를 사용하여 개체의 네임스페이스 및 클래스를 지정합니다.

예 3

C:\PS>$zip | get-member -type 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

설명
-----------
이 명령은 Get-Member cmdlet을 사용하여 웹 서비스 프록시 개체의 메서드를 $zip 변수에 표시합니다. 다음 예에서 이러한 메서드를 사용합니다.

프록시 개체의 TypeName인 WebServiceProxy는 위 예에서 지정된 네임스페이스 및 클래스 이름을 반영합니다.

예 4

C:\PS>$zip.getinfobyzip(20500).table

CITY      : Washington
STATE     : DC
ZIP       : 20500
AREA_CODE : 202
TIME_ZONE : E

설명
-----------
이 명령은 Zip 변수에 저장된 웹 서비스 프록시를 사용합니다. 프록시의 GetInfoByZip 메서드와 해당 Table 속성을 사용합니다.

참고 항목

개념

New-Service

다음을 통해 공유