{"id":51993,"date":"2009-11-17T00:01:00","date_gmt":"2009-11-17T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2009\/11\/17\/hey-scripting-guy-how-can-i-use-web-services\/"},"modified":"2009-11-17T00:01:00","modified_gmt":"2009-11-17T00:01:00","slug":"hey-scripting-guy-how-can-i-use-web-services","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/hey-scripting-guy-how-can-i-use-web-services\/","title":{"rendered":"Hey, Scripting Guy! How Can I Use Web Services?"},"content":{"rendered":"

\"Bookmark<\/a><\/p>\n

 <\/p>\n

\"Hey,<\/p>\n

Hey, Scripting Guy! I remember reading about things called “Web services” a long time ago. It seems that I do not hear much about these anymore. Do they really exist, and if so what are they good for?<\/p>\n

— GK<\/p>\n

\"Hey,Hello GK, <\/p>\n

Microsoft Scripting Guy Ed Wilson here. We have had to batten down the hatches here in Charlotte, North Carolina, as the tropical storm formerly known as Hurricane Ida makes a guest appearance in our neighborhood. The 50-foot tall southern pines that inhabit my yard are doing their version of the hula, and the handmade specially tuned wind chime on our front porch is playing a ghostly tune. The sky is dark and the wind whips down the street like a freight train crossing the great planes on a mission of sinister importance. Strangely, eerily perhaps, it seems there is no noise—and then it hits—all at once a great cacophony of rushing wind, overturned lawn furniture banging and clanging as it rolls across yards, and all the time the 4\/4 staccato of the wind chime marks the beat of an unseen conductor. <\/p>\n

GK, because we often receive extreme weather during hurricane season, I am extremely interested in the weather. However, I am even more interested in writing scripts. It would be awesome if I could combine both activities. What one needs is an easy-to-use way to query for current weather information. I know of dozens of Web sites I can go to (including the newly redesigned MSN page) where I can find current weather information. I can, of course, open the Web page in a script and display it, but I prefer a quick and easy way to obtain only the weather information, and to bypass the browser completely. To do this, I need to use a Web service, which returns information in an optimized manner. The data returns in XML format, and an application or script easily parses the information. This requires a little understanding of XML. The complete Get-InternationalWeather.ps1 script shown here illustrates the technique. <\/p>\n

Get-InternationalWeather.ps1<\/strong><\/p>\n

#Requires -version 2.0<\/p>\n

Function Get-Weather
{
 <\/span>Param(
  <\/span>[Parameter(Mandatory=$true)]
  <\/span>[string]$city,
  <\/span>[Parameter(Mandatory=$true)]
  <\/span>[string]$country
 <\/span>)#end param
 <\/span>$URI = “http:\/\/www.webservicex.net\/globalweather.asmx?wsdl”
 <\/span>$Proxy = New-WebServiceProxy -uri $URI -namespace WebServiceProxy
 <\/span>$Proxy.GetWeather($city,$country)
} #end Get-Weather<\/p>\n

[xml]$xml = Get-Weather -city “sydney airport” -country “Australia”
$xml.CurrentWeather<\/p>\n

<\/font><\/font><\/span><\/p>\n

The Get-InternationalWeather.ps1 script begins by declaring a function named Get-Weather<\/b>. The Get-Weather<\/b> function accepts two input parameters, city<\/b> and country<\/b>. Both parameters are strings, and both are mandatory. The [Parameter(Mandatory=$true)]<\/b> tag is new for Windows PowerShell 2.0 and is used to force a parameter to be present when the script runs. If the script runs without values for either the country<\/strong> or the city<\/strong> parameter, the following error appears:<\/p>\n

\"Image
<\/p>\n

The Get-Weather<\/b> function parameter section is shown here: <\/p>\n

Function Get-Weather
{
 <\/span>Param(
  <\/span>[Parameter(Mandatory=$true)]
  <\/span>[string]$city,
  <\/span>[Parameter(Mandatory=$true)]
  <\/span>[string]$country
 <\/span>)#end param<\/p>\n

<\/font><\/span><\/p>\n

The Uniform Resource Identifier (URI)<\/font><\/a> string points to the Web Services Description Language (WSDL)<\/font><\/a> page. The WSDL describes the Web service offerings. Each service is a collection of network end points. The WSDL uses XML to define the query method. In the WSDL seen here, the GetWeather<\/b> method takes two inputs: CityName<\/b> and CountryName<\/b>, both of which are strings:<\/p>\n

  <?xml version=”1.0″ encoding=”utf-8″ ?>
<\/font>–<\/font><\/span><\/a> <wsdl:definitions xmlns:soap=”http:\/\/schemas.xmlsoap.org\/wsdl\/soap\/” xmlns:tm=”http:\/\/microsoft.com\/wsdl\/mime\/textMatching\/” xmlns:soapenc=”http:\/\/schemas.xmlsoap.org\/soap\/encoding\/” xmlns:mime=”http:\/\/schemas.xmlsoap.org\/wsdl\/mime\/” xmlns:tns=”http:\/\/www.webserviceX.NET” xmlns:s=”http:\/\/www.w3.org\/2001\/XMLSchema” xmlns:soap12=”http:\/\/schemas.xmlsoap.org\/wsdl\/soap12\/” xmlns:http=”http:\/\/schemas.xmlsoap.org\/wsdl\/http\/” targetNamespace=”http:\/\/www.webserviceX.NET” xmlns:wsdl=”http:\/\/schemas.xmlsoap.org\/wsdl\/”>
<\/font>–<\/font><\/span><\/a> <wsdl:types>
<\/font>–<\/font><\/span><\/a> <s:schema elementFormDefault=”qualified” targetNamespace=”http:\/\/www.webserviceX.NET”>
<\/font>–<\/font><\/span><\/a> <s:element name=”GetWeather”>
<\/font>–<\/font><\/span><\/a> <s:complexType>
<\/font>–<\/font><\/span><\/a> <s:sequence>
  <s:element minOccurs=”0″ maxOccurs=”1″ name=”CityName” type=”s:string” \/>
  <s:element minOccurs=”0″ maxOccurs=”1″ name=”CountryName” type=”s:string” \/>
  <\/s:sequence>
  <\/s:complexType>
  <\/s:element><\/p>\n

<\/font><\/span><\/p>\n

The $URI<\/b> variable holds the path to the globalweather<\/b> WSDL. The string assignment listing follows:<\/p>\n

$URI = http:\/\/www.webservicex.net\/globalweather.asmx?wsdl<\/p>\n

<\/font><\/span><\/p>\n

The key feature of the Get-InternationalWeather.ps1 script uses the New-WebServiceProxy<\/b> Windows PowerShell cmdlet to make the connection to the globalweather<\/b> Web service. After the connection to the Web service is established, the resulting connection is stored in the $proxy<\/b> variable as seen here:<\/p>\n

$Proxy = New-WebServiceProxy -uri $URI -namespace WebServiceProxy<\/p>\n

<\/font><\/span><\/p>\n

It is finally time to retrieve the weather. To do this, call the GetWeather<\/b> method from the globalweather<\/b> Web service. The GetWeather<\/b> method call receives both a city and a country as seen here:<\/p>\n

$Proxy.GetWeather($city,$country)
} #end Get-Weather<\/p>\n

<\/font><\/span><\/p>\n

When calling the GetWeather<\/b> method, keep in mind that the returned data is XML. The raw XML returned by the GetWeather<\/b> method is shown here: <\/p>\n

<?xml version=”1.0″ encoding=”utf-16″?>
<CurrentWeather>
  <\/span><Location>Sydney Airport, Australia (YSSY) 33-57S 151-11E 3M<\/Location>
  <\/span><Time>Nov 12, 2009 – 01:00 PM EST \/ 2009.11.12 1800 UTC<\/Time>
  <\/span><Wind> from the S (180 degrees) at 22 MPH (19 KT):0<\/Wind>
  <\/span><Visibility> greater than 7 mile(s):0<\/Visibility>
  <\/span><SkyConditions> partly cloudy<\/SkyConditions>
  <\/span><Temperature> 68 F (20 C)<\/Temperature>
  <\/span><DewPoint> 64 F (18 C)<\/DewPoint>
  <\/span><RelativeHumidity> 88%<\/RelativeHumidity>
  <\/span><Pressure> 30.03 in. Hg (1017 hPa)<\/Pressure>
  <\/span><Status>Success<\/Status>
<\/CurrentWeather><\/p>\n

[xml]$xml = Get-Weather -city “sydney airport” -country “Australia”<\/p>\n

<\/font><\/span><\/p>\n

By exploring the contents of the $xml<\/b> variable, you can see there are two properties that are reported. The first is XML<\/b> and the second property is CurrentWeather<\/b>. This is seen here:<\/p>\n

PS C:Usersed.NWTRADERS> $xml | get-member -MemberType property<\/p>\n


   <\/span>TypeName: System.Xml.XmlDocument<\/p>\n

Name           <\/span>MemberType Definition                                 <\/span>
—-           <\/span>———- ———-                                 <\/span>
CurrentWeather Property   <\/span>System.Xml.XmlElement CurrentWeather {get;}
xml            <\/span>Property   <\/span>System.String xml {get;set;}      <\/span><\/p>\n

<\/font><\/span><\/p>\n

The CurrentWeather<\/b> property returns a CurrentWeather<\/b> object. This object contains a number of properties that are seen here:<\/p>\n

PS C:Usersed.NWTRADERS> $xml.CurrentWeather | Get-Member -MemberType property<\/p>\n


   <\/span>TypeName: System.Xml.XmlElement<\/p>\n

Name             <\/span>MemberType Definition                               <\/span>
—-             <\/span>———- ———-                               <\/span>
DewPoint         <\/span>Property   <\/span>System.String DewPoint {get;set;}        <\/span>
Location         <\/span>Property   <\/span>System.String Location {get;set;}  <\/span>      <\/span>
Pressure         <\/span>Property   <\/span>System.String Pressure {get;set;}        <\/span>
RelativeHumidity Property   <\/span>System.String RelativeHumidity {get;set;}
SkyConditions    <\/span>Property   <\/span>System.String SkyConditions {get;set;}   <\/span>
Status           <\/span>Property   <\/span>System.String Status {get;set;}          <\/span>
Temperature      <\/span>Property   <\/span>System.String Temperature {get;set;}     <\/span>
Time             <\/span>Property   <\/span>System.String Time {get;set;}            <\/span>
Visibility       <\/span>Property   <\/span>System.String Visibility {get;set;}      <\/span>
Wind           <\/span>  <\/span>Property   <\/span>System.String Wind {get;set;}            <\/span><\/p>\n

<\/font><\/span><\/p>\n

Because each of the weather elements is available as an individual property, it is possible to access specific values such as the temperature. This is seen here:<\/p>\n

PS C:Usersed.NWTRADERS> $xml.CurrentWeather.Temperature
 <\/span>66 F (19 C)<\/p>\n

<\/font><\/span><\/p>\n

For the Get-InternationalWeather.ps1 script, the complete weather information is shown. To do this, the CurrentWeather<\/b> property is queried as seen here:<\/p>\n

$xml.CurrentWeather<\/p>\n

<\/font><\/span><\/p>\n

The result of running the Get-InternationalWeather.ps1 script is shown here:<\/p>\n

\"Image<\/p>\n

 <\/p>\n

Well, GK, as you can see, Web services are alive and well. In fact, they have taken on new importance because of their ease of use from within Windows PowerShell. Join us tomorrow as XML Week continues. <\/p>\n

If you want to know exactly what we will be looking at tomorrow, follow us on Twitter<\/font><\/a> or Facebook<\/font><\/a>. If you have any questions, send e-mail to us at scripter@microsoft.com<\/font><\/a> or post your questions on the Official Scripting Guys Forum<\/font><\/a>. See you tomorrow. Until then, peace.<\/p>\n

 <\/p>\n

Ed Wilson and Craig Liebendorfer, Scripting Guys<\/span><\/b><\/p>\n

 <\/p>\n","protected":false},"excerpt":{"rendered":"

  Hey, Scripting Guy! I remember reading about things called “Web services” a long time ago. It seems that I do not hear much about these anymore. Do they really exist, and if so what are they good for? — GK Hello GK, Microsoft Scripting Guy Ed Wilson here. We have had to batten down […]<\/p>\n","protected":false},"author":595,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[3,4,45,165],"class_list":["post-51993","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-scripting-guy","tag-scripting-techniques","tag-windows-powershell","tag-xml"],"acf":[],"blog_post_summary":"

  Hey, Scripting Guy! I remember reading about things called “Web services” a long time ago. It seems that I do not hear much about these anymore. Do they really exist, and if so what are they good for? — GK Hello GK, Microsoft Scripting Guy Ed Wilson here. We have had to batten down […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/51993","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/users\/595"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=51993"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/51993\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media\/87096"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media?parent=51993"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=51993"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=51993"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}