winrm 0.0.1

data/README

@@ -0,0 +1,53 @@
+--------------------------------------------------------------------------
+              Windows Remote Management (WinRM) for Ruby
+--------------------------------------------------------------------------
+This is a SOAP library that uses the functionality in Windows Remote
+Management(WinRM) to call native object in Windows.  This includes, but is
+not limitted to, running batch scripts, powershell scripts and fetching WMI
+variables.  For more information on WinRM, please visit Microsoft's WinRM
+site: http://msdn.microsoft.com/en-us/library/aa384426(v=VS.85).aspx
+
+
+My Info: 
+BLOG:  http://distributed-frostbite.blogspot.com/
+Add me in LinkedIn:  http://www.linkedin.com/in/danwanek
+
+--------------------------------------------------------------------------
+--------------------------------------------------------------------------
+TO USE:
+require 'winrm'
+# See REQUIRED GEMS below
+
+gem install -r winrm
+
+REQUIRED GEMS: (These should automatically install with the winrm gem)
+# Handsoap
+gem install -r handsoap
+# Nokogiri XML Parser
+gem install -r nokogiri
+# HttpClient
+gem install -r httpclient
+# NTLM Library
+gem install -r rubyntlm
+#UUID Library
+gem install -r uuid
+
+
+EXAMPLE:
+require 'winrm'
+WinRM::WinRM.endpoint = 'http://mywinrmhost:5985/wsman'
+WinRM::WinRM.set_auth('user','password')
+winrm = WinRM::WinRM.instance
+output = winrm.winrm.run_powershell_script 'script.ps1'
+puts output[:stdout]
+
+--------------------------------------------------------------------------
+DISCLAIMER:  If you see something that could be done better or would like
+to help out in the development of this code please feel free to clone the
+'git' repository and send me patches:
+git clone git://github.com/zenchild/WinRM.git
+or add an issue on GitHub:
+http://github.com/zenchild/WinRM/issues
+
+Cheers!
+--------------------------------------------------------------------------

data/Rakefile

@@ -0,0 +1,69 @@
+require 'rubygems'
+require 'rake/clean'
+require 'rake/gempackagetask'
+require 'date'
+
+CLEAN.include("pkg")
+CLEAN.include("doc")
+
+GEMSPEC = Gem::Specification.new do |gem|
+  gem.name = "winrm"
+  gem.version = File.open('VERSION').readline.chomp
+  gem.date		= Date.today.to_s
+  gem.platform = Gem::Platform::RUBY
+  gem.rubyforge_project  = nil
+
+  gem.author = "Dan Wanek"
+  gem.email = "dan.wanek@gmail.com"
+  gem.homepage = "http://github.com/zenchild/WinRM"
+
+  gem.summary = 'Ruby library for Windows Remote Management'
+  gem.description	= <<-EOF
+    Ruby library for Windows Remote Management
+  EOF
+
+  gem.files = `git ls-files`.split(/\n/)
+  gem.require_path = "lib"
+  gem.rdoc_options	= %w(-x test/ -x examples/)
+  gem.extra_rdoc_files = %w(README COPYING.txt)
+
+  gem.required_ruby_version	= '>= 1.8.7'
+  gem.add_runtime_dependency  'handsoap'
+  gem.add_runtime_dependency  'nokogiri'
+  gem.add_runtime_dependency  'httpclient'
+  gem.add_runtime_dependency  'rubyntlm'
+  gem.add_runtime_dependency  'uuid'
+end
+ 
+Rake::GemPackageTask.new(GEMSPEC) do |pkg|
+  pkg.need_tar = true
+end
+
+task :default => [:buildgem]
+
+desc "Build the gem without a version change"
+task :buildgem => [:clean, :repackage]
+
+desc "Build the gem, but increment the version first"
+task :newrelease => [:versionup, :clean, :repackage]
+
+
+desc "Increment the version by 1 minor release"
+task :versionup do
+	ver = up_min_version
+	puts "New version: #{ver}"
+end
+
+
+def up_min_version
+	f = File.open('VERSION', 'r+')
+	ver = f.readline.chomp
+	v_arr = ver.split(/\./).map do |v|
+		v.to_i
+	end
+	v_arr[2] += 1
+	ver = v_arr.join('.')
+	f.rewind
+	f.write(ver)
+	ver
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/lib/extensions/string.rb

@@ -0,0 +1,37 @@
+#############################################################################
+# Copyright © 2010 Dan Wanek <dan.wanek@gmail.com>
+#
+#
+# This file is part of WinRM.
+# 
+# WinRM is free software: you can redistribute it and/or
+# modify it under the terms of the GNU General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or (at
+# your option) any later version.
+# 
+# WinRM is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
+# Public License for more details.
+# 
+# You should have received a copy of the GNU General Public License along
+# with WinRM.  If not, see <http://www.gnu.org/licenses/>.
+#############################################################################
+
+# Custom extensions to the class String
+class String
+  # Change CamelCased strings to ruby_cased strings
+  # It uses the lookahead assertion ?=  In this case it basically says match
+  # anything followed by a capital letter, but not the capital letter itself.
+  # @see http://www.pcre.org/pcre.txt The PCRE guide for more details
+  def ruby_case
+    self.split(/(?=[A-Z])/).join('_').downcase
+  end
+
+  # Change a ruby_cased string to CamelCased
+  def camel_case
+    self.split(/_/).map { |i|
+      i.sub(/^./) { |s| s.upcase }
+    }.join
+  end
+end # String

data/lib/soap/exceptions/exceptions.rb

@@ -0,0 +1,28 @@
+#############################################################################
+# Copyright © 2010 Dan Wanek <dan.wanek@gmail.com>
+#
+#
+# This file is part of WinRM.
+# 
+# WinRM is free software: you can redistribute it and/or
+# modify it under the terms of the GNU General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or (at
+# your option) any later version.
+# 
+# WinRM is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
+# Public License for more details.
+# 
+# You should have received a copy of the GNU General Public License along
+# with WinRM.  If not, see <http://www.gnu.org/licenses/>.
+#############################################################################
+
+module WinRM
+  module SOAP
+    # Generic WinRM SOAP Error
+    class WinRMWebServiceError < StandardError
+    end
+  end # SOAP
+end # WinRM
+ 

data/lib/soap/soap_provider.rb

@@ -0,0 +1,36 @@
+#############################################################################
+# Copyright © 2010 Dan Wanek <dan.wanek@gmail.com>
+#
+#
+# This file is part of WinRM.
+# 
+# WinRM is free software: you can redistribute it and/or
+# modify it under the terms of the GNU General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or (at
+# your option) any later version.
+# 
+# WinRM is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
+# Public License for more details.
+# 
+# You should have received a copy of the GNU General Public License along
+# with WinRM.  If not, see <http://www.gnu.org/licenses/>.
+#############################################################################
+require 'handsoap'
+
+module WinRM
+  module SOAP
+    NS_ADDRESSING  ='a'   # http://schemas.xmlsoap.org/ws/2004/08/addressing
+    NS_CIMBINDING  ='b'   # http://schemas.dmtf.org/wbem/wsman/1/cimbinding.xsd
+    NS_ENUM        ='n'   # http://schemas.xmlsoap.org/ws/2004/09/enumeration
+    NS_TRANSFER    ='x'   # http://schemas.xmlsoap.org/ws/2004/09/transfer
+    NS_WSMAN_DMTF  ='w'   # http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd
+    NS_WSMAN_MSFT  ='p'   # http://schemas.microsoft.com/wbem/wsman/1/wsman.xsd
+    NS_SCHEMA_INST ='xsi' # http://www.w3.org/2001/XMLSchema-instance
+    NS_WIN_SHELL   ='rsp' # http://schemas.microsoft.com/wbem/wsman/1/windows/shell
+  end
+end
+
+require 'soap/exceptions/exceptions'
+require 'soap/winrm_service'

data/lib/soap/winrm_service.rb

@@ -0,0 +1,345 @@
+#############################################################################
+# Copyright © 2010 Dan Wanek <dan.wanek@gmail.com>
+#
+#
+# This file is part of WinRM.
+# 
+# WinRM is free software: you can redistribute it and/or
+# modify it under the terms of the GNU General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or (at
+# your option) any later version.
+# 
+# WinRM is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
+# Public License for more details.
+# 
+# You should have received a copy of the GNU General Public License along
+# with WinRM.  If not, see <http://www.gnu.org/licenses/>.
+#############################################################################
+Handsoap.http_driver = :http_client
+
+module WinRM
+  module SOAP
+    class WinRMWebService < Handsoap::Service
+      include SOAP
+
+      @@raw_soap = false
+
+      def initialize()
+        if $DEBUG
+          @debug = File.new('winrm_debug.out', 'w')
+          @debug.sync = true
+        end
+        
+      end
+
+      def self.set_auth(user,pass)
+        @@user = user
+        @@pass = pass
+      end
+
+      # Turn off parsing and just return the soap response
+      def self.raw_soap!
+        @@raw_soap = true
+      end
+
+
+      # ********* Begin Hooks *********
+
+      def on_create_document(doc)
+        doc.alias NS_ADDRESSING, 'http://schemas.xmlsoap.org/ws/2004/08/addressing'
+        doc.alias NS_ENUM,       'http://schemas.xmlsoap.org/ws/2004/09/enumeration'
+        doc.alias NS_WSMAN_DMTF, 'http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd'
+        doc.alias NS_WSMAN_MSFT, 'http://schemas.microsoft.com/wbem/wsman/1/wsman.xsd'
+        doc.alias NS_SCHEMA_INST,'http://www.w3.org/2001/XMLSchema-instance'
+        doc.alias NS_WIN_SHELL,  'http://schemas.microsoft.com/wbem/wsman/1/windows/shell'
+        doc.alias NS_CIMBINDING, 'http://schemas.dmtf.org/wbem/wsman/1/cimbinding.xsd'
+
+        header = doc.find('Header')
+        header.add("#{NS_ADDRESSING}:To", WinRMWebService.uri)
+        header.add("#{NS_ADDRESSING}:ReplyTo") {|rto|
+          rto.add("#{NS_ADDRESSING}:Address",'http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous') {|addr|
+            addr.set_attr('mustUnderstand','true')
+          }
+        }
+        header.add("#{NS_WSMAN_DMTF}:MaxEnvelopeSize",'153600') {|mes|
+          mes.set_attr('mustUnderstand','true')
+        }
+        header.add("#{NS_ADDRESSING}:MessageID", "uuid:#{UUID.generate.upcase}")
+        header.add("#{NS_WSMAN_DMTF}:Locale") {|loc|
+          loc.set_attr('xml:lang','en-US')
+          loc.set_attr('mustUnderstand','false')
+        }
+        header.add("#{NS_WSMAN_MSFT}:DataLocale") {|loc|
+          loc.set_attr('xml:lang','en-US')
+          loc.set_attr('mustUnderstand','false')
+        }
+        header.add("#{NS_WSMAN_DMTF}:OperationTimeout",'PT60.000S')
+      end
+
+      # Adds knowledge of namespaces to the response object.  These have to be identical to the 
+      # URIs returned in the XML response.  For example, I had some issues with the 'soap'
+      # namespace because my original URI did not end in a '/'
+      # @example
+      #   Won't work: http://schemas.xmlsoap.org/soap/envelope
+      #   Works: http://schemas.xmlsoap.org/soap/envelope/
+      def on_response_document(doc)
+        doc.add_namespace NS_ADDRESSING, 'http://schemas.xmlsoap.org/ws/2004/08/addressing'
+        doc.add_namespace NS_ENUM,       'http://schemas.xmlsoap.org/ws/2004/09/enumeration'
+        doc.add_namespace NS_TRANSFER,   'http://schemas.xmlsoap.org/ws/2004/09/transfer'
+        doc.add_namespace NS_WSMAN_DMTF, 'http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd'
+        doc.add_namespace NS_WSMAN_MSFT, 'http://schemas.microsoft.com/wbem/wsman/1/wsman.xsd'
+        doc.add_namespace NS_WIN_SHELL,  'http://schemas.microsoft.com/wbem/wsman/1/windows/shell'
+        doc.add_namespace NS_CIMBINDING, 'http://schemas.dmtf.org/wbem/wsman/1/cimbinding.xsd'
+      end
+
+      def on_after_create_http_request(req)
+        req.set_auth @@user, @@pass
+        req.set_header('Content-Type','application/soap+xml;charset=UTF-8')
+        #puts "SOAP DOCUMENT=\n#{req.body}"
+      end
+
+      def on_http_error(resp)
+        puts "HTTP ERROR: #{resp.status}"
+        puts "HEADERS=\n#{resp.headers}"
+        puts "BODY=\n#{resp.body}"
+      end
+
+
+      # ********** End Hooks **********
+
+
+      # Create a Shell on the destination host
+      # @param [String<optional>] i_stream Which input stream to open.  Leave this alone unless you know what you're doing
+      # @param [String<optional>] o_stream Which output stream to open.  Leave this alone unless you know what you're doing
+      # @return [String] The ShellId from the SOAP response.  This is our open shell instance on the remote machine.
+      def open_shell(i_stream = 'stdin', o_stream = 'stdout stderr')
+        header = {
+          "#{NS_WSMAN_DMTF}:OptionSet" => [
+            {"#{NS_WSMAN_DMTF}:Option" => {:name => 'WINRS_NOPROFILE', :text =>"FALSE"}},
+            {"#{NS_WSMAN_DMTF}:Option" => {:name => 'WINRS_CODEPAGE', :text =>"437"}}
+          ]
+        }.merge(resource_uri_cmd).merge(action_create)
+
+        resp = invoke("#{NS_WIN_SHELL}:Shell", {:soap_action => :auto, :http_options => nil, :soap_header => header}) do |shell|
+          shell.add("#{NS_WIN_SHELL}:InputStreams", i_stream)
+          shell.add("#{NS_WIN_SHELL}:OutputStreams",o_stream)
+        end
+
+        # Get the Shell ID from the response
+        (resp/"//*[@Name='ShellId']").to_s
+      end
+
+      # Run a command on a machine with an open shell
+      # @param [String] shell_id The shell id on the remote machine.  See #open_shell
+      # @param [String] command The command to run on the remote machine
+      # @return [String] The CommandId from the SOAP response.  This is the ID we need to query in order to get output.
+      def run_command(shell_id, command)
+        header = {
+          "#{NS_WSMAN_DMTF}:OptionSet" => {
+            "#{NS_WSMAN_DMTF}:Option" => {:name => 'WINRS_CONSOLEMODE_STDIN', :text =>"TRUE"},
+          }
+        }.merge(resource_uri_cmd).merge(action_command).merge(selector_shell_id(shell_id))
+
+        # Issue the Command
+        resp = invoke("#{NS_WIN_SHELL}:CommandLine", {:soap_action => :auto, :http_options => nil, :soap_header => header}) do |cli|
+          cli.add("#{NS_WIN_SHELL}:Command","\"#{command}\"")
+        end
+
+        (resp/"//#{NS_WIN_SHELL}:CommandId").to_s
+      end
+
+      # Get the Output of the given shell and command
+      # @param [String] shell_id The shell id on the remote machine.  See #open_shell
+      # @param [String] command_id The command id on the remote machine.  See #run_command
+      # @return [Hash] :stdout and :stderr
+      def get_command_output(shell_id, command_id)
+        header = {}.merge(resource_uri_cmd).merge(action_receive).merge(selector_shell_id(shell_id))
+
+        # Get Command Output
+        resp = invoke("#{NS_WIN_SHELL}:Receive", {:soap_action => :auto, :http_options => nil, :soap_header => header}) do |rec|
+          rec.add("#{NS_WIN_SHELL}:DesiredStream",'stdout stderr') do |ds|
+            ds.set_attr('CommandId', command_id)
+          end
+        end
+
+        cmd_stdout = ''
+        cmd_stderr = ''
+        (resp/"//*[@Name='stdout']").each do |n|
+          next if n.to_s.nil?
+          cmd_stdout << Base64.decode64(n.to_s)
+        end
+        (resp/"//*[@Name='stderr']").each do |n|
+          next if n.to_s.nil?
+          cmd_stderr << Base64.decode64(n.to_s)
+        end
+        {:stdout => cmd_stdout, :stderr => cmd_stderr}
+      end
+
+      # Clean-up after a command.
+      # @see #run_command
+      # @param [String] shell_id The shell id on the remote machine.  See #open_shell
+      # @param [String] command_id The command id on the remote machine.  See #run_command
+      # @return [true] This should have more error checking but it just returns true for now.
+      def cleanup_command(shell_id, command_id)
+        header = {}.merge(resource_uri_cmd).merge(action_signal).merge(selector_shell_id(shell_id))
+        # Signal the Command references to terminate (close stdout/stderr)
+        resp = invoke("#{NS_WIN_SHELL}:Signal", {:soap_action => :auto, :http_options => nil, :soap_header => header}) do |sig|
+          sig.set_attr('CommandId', command_id)
+          sig.add("#{NS_WIN_SHELL}:Code",'http://schemas.microsoft.com/wbem/wsman/1/windows/shell/signal/terminate')
+        end
+        true
+      end
+
+      # Close the shell
+      # @param [String] shell_id The shell id on the remote machine.  See #open_shell
+      # @return [true] This should have more error checking but it just returns true for now.
+      def close_shell(shell_id)
+        header = {}.merge(resource_uri_cmd).merge(action_delete).merge(selector_shell_id(shell_id))
+        # Delete the Shell reference
+        resp = invoke(:nil_body, {:soap_action => nil, :soap_body => true, :http_options => nil, :soap_header => header})
+        true
+      end
+
+      # Run a Powershell script that resides on the local box.
+      # @param [String] script_file The string representing the path to a Powershell script
+      # @return [Hash] :stdout and :stderr
+      def run_powershell_script(script_file)
+        script = File.read(script_file)
+        script = script.chars.to_a.join("\x00").chomp.encode('ASCII-8BIT')
+        script = Base64.strict_encode64(script)
+
+        shell_id = open_shell
+        command_id =  run_command(shell_id, "powershell -encodedCommand #{script}")
+        command_output = get_command_output(shell_id, command_id)
+        cleanup_command(shell_id, command_id)
+        close_shell(shell_id)
+        command_output
+      end
+
+
+      # Run a WQL Query
+      # @see http://msdn.microsoft.com/en-us/library/aa394606(VS.85).aspx
+      # @param [String] wql The WQL query
+      # @return [Array<Hash>] Returns an array of Hashes that contain the key/value pairs returned from the query.
+      def run_wql(wql)
+        header = {}.merge(resource_uri_wmi).merge(action_enumerate)
+
+        begin
+          resp = invoke("#{NS_ENUM}:Enumerate", {:soap_action => :auto, :http_options => nil, :soap_header => header}) do |enum|
+            enum.add("#{NS_WSMAN_DMTF}:OptimizeEnumeration")
+            enum.add("#{NS_WSMAN_DMTF}:MaxElements",'32000')
+            mattr = nil
+            enum.add("#{NS_WSMAN_DMTF}:Filter", wql) do |filt|
+              filt.set_attr('Dialect','http://schemas.microsoft.com/wbem/wsman/1/WQL')
+            end
+          end
+        rescue Handsoap::Fault => e
+          raise WinRMWebServiceError, e.reason
+        end
+
+        query_response = []
+        (resp/"//#{NS_ENUM}:EnumerateResponse//#{NS_WSMAN_DMTF}:Items/*").each do |i|
+          qitem = {}
+          (i/'*').each do |si|
+            qitem[si.node_name] = si.to_s
+          end
+          query_response << qitem
+        end
+        query_response
+      end
+
+
+      # To create an empty body set :soap_body => true in the invoke options and set the action to :nil_body
+      def iterate_hash_array(element, hash_array)
+        add_hierarchy!(element, hash_array, nil) unless hash_array.key?(:nil_body)
+      end
+
+
+      protected
+
+      # Add a hierarchy of elements from hash data
+      # @example Hash to XML
+      #   {:this => {:text =>'that'},'top' => {:id => '32fss', :text => 'TestText', {'middle' => 'bottom'}}}
+      #   becomes...
+      #   <this>that</this>
+      #   <top Id='32fss'>
+      #     TestText
+      #     <middle>bottom</middle>
+      #   </top>
+      def add_hierarchy!(node, e_hash, prefix = NS_ADDRESSING)
+        prefix << ":" unless prefix.nil?
+        e_hash.each_pair do |k,v|
+          name = (k.is_a?(Symbol) && k != :text) ? k.to_s.camel_case : k
+          if v.is_a? Hash
+            node.add("#{prefix}#{name}", v[:text]) do |n|
+              add_hierarchy!(n, v, prefix)
+            end
+          elsif v.is_a? Array
+            node.add("#{prefix}#{name}") do |n|
+              v.each do |i|
+                add_hierarchy!(n, i, prefix)
+              end
+            end
+          else
+            node.set_attr(name, v) unless k == :text
+          end
+        end
+      end
+
+
+      # Private Methods (Builders and Parsers)
+      private
+
+      def build!(node, opts = {}, &block)
+        #EwsBuilder.new(node, opts, &block)
+      end
+
+      def parse!(response, opts = {})
+        return response if @@raw_soap
+        #EwsParser.new(response).parse(opts)
+      end
+
+
+      # Helper methods for SOAP Headers
+
+      def resource_uri_cmd
+        {"#{NS_WSMAN_DMTF}:ResourceURI" => {'mustUnderstand' => 'true', :text => 'http://schemas.microsoft.com/wbem/wsman/1/windows/shell/cmd'}}
+      end
+
+      def resource_uri_wmi(namespace = 'root/cimv2/*')
+        {"#{NS_WSMAN_DMTF}:ResourceURI" => {'mustUnderstand' => 'true', :text => "http://schemas.microsoft.com/wbem/wsman/1/wmi/#{namespace}"}}
+      end
+
+      def action_create
+        {"#{NS_ADDRESSING}:Action" => {'mustUnderstand' => 'true', :text => 'http://schemas.xmlsoap.org/ws/2004/09/transfer/Create'}}
+      end
+
+      def action_delete
+        {"#{NS_ADDRESSING}:Action" => {'mustUnderstand' => 'true', :text => 'http://schemas.xmlsoap.org/ws/2004/09/transfer/Delete'}}
+      end
+
+      def action_command
+        {"#{NS_ADDRESSING}:Action" => {'mustUnderstand' => 'true', :text => 'http://schemas.microsoft.com/wbem/wsman/1/windows/shell/Command'}}
+      end
+
+      def action_receive
+        {"#{NS_ADDRESSING}:Action" => {'mustUnderstand' => 'true', :text => 'http://schemas.microsoft.com/wbem/wsman/1/windows/shell/Receive'}}
+      end
+
+      def action_signal
+        {"#{NS_ADDRESSING}:Action" => {'mustUnderstand' => 'true', :text => 'http://schemas.microsoft.com/wbem/wsman/1/windows/shell/Signal'}}
+      end
+
+      def action_enumerate
+        {"#{NS_ADDRESSING}:Action" => {'mustUnderstand' => 'true', :text => 'http://schemas.xmlsoap.org/ws/2004/09/enumeration/Enumerate'}}
+      end
+
+      def selector_shell_id(shell_id)
+        {"#{NS_WSMAN_DMTF}:SelectorSet" => {"#{NS_WSMAN_DMTF}:Selector" => {:name => 'ShellId', :text => shell_id}}}
+      end
+
+    end # class WinRMWebService
+  end # module SOAP
+end # WinRM

data/lib/winrm.rb

@@ -0,0 +1,89 @@
+#############################################################################
+# Copyright © 2010 Dan Wanek <dan.wanek@gmail.com>
+#
+#
+# This file is part of WinRM.
+# 
+# WinRM is free software: you can redistribute it and/or
+# modify it under the terms of the GNU General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or (at
+# your option) any later version.
+# 
+# WinRM is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
+# Public License for more details.
+# 
+# You should have received a copy of the GNU General Public License along
+# with WinRM.  If not, see <http://www.gnu.org/licenses/>.
+#############################################################################
+
+# We only what one instance of this class so include Singleton
+require 'singleton'
+require 'date'
+require 'base64'
+require 'uuid'
+require 'kconv'
+
+# Class Extensions
+require 'extensions/string'
+
+# Load the backend SOAP infrastructure.  Today this is Handsoap.
+require 'soap/soap_provider'
+
+
+module WinRM
+  class WinRM
+    include Singleton
+
+    attr_reader :winrm
+
+    # Set the endpoint for WinRM Web Services.  
+    # @param [String] endpoint The URL of the endpoint.
+    #   https://myserver:5986/wsman
+    # @param [Integer] version The SOAP version to use.  This defaults to 1
+    #   and you should not need to pass this parameter.
+    def self.endpoint=(endpoint, version = 2)
+      @@endpoint = endpoint
+      SOAP::WinRMWebService.endpoint(:uri => endpoint, :version => version)
+    end
+
+    # Fetch the current endpoint
+    def self.endpoint
+      @@endpoint
+    end
+
+    # Set the SOAP username and password.
+    # @param [String] user The user name
+    # @param [String] pass The password
+    def self.set_auth(user,pass)
+      @@user = user
+      SOAP::WinRMWebService.set_auth(user,pass)
+    end
+
+    # Set the http driver that the SOAP back-end will use.
+    # @param [Symbol] driver The HTTP driver.  Available drivers:
+    #   :curb, :net_http, :http_client(Default)
+    def self.set_http_driver(driver)
+      Handsoap.http_driver = driver
+    end
+
+    def initialize
+      @winrm = SOAP::WinRMWebService.new
+    end
+
+    # Run a Powershell script
+    # @see WinRM::SOAP::WinRMWebService#run_powershell_script
+    def powershell(script_file)
+      @winrm.run_powershell_script(script_file)
+    end
+
+    # Run a WQL Query
+    # @see WinRM::SOAP::WinRMWebService#run_wql
+    # @see http://msdn.microsoft.com/en-us/library/aa394606(VS.85).aspx
+    def wql(wql)
+      @winrm.run_wql(wql)
+    end
+
+  end # class WinRM
+end

data/preamble

@@ -0,0 +1,19 @@
+#############################################################################
+# Copyright © 2010 Dan Wanek <dan.wanek@gmail.com>
+#
+#
+# This file is part of WinRM.
+# 
+# WinRM is free software: you can redistribute it and/or
+# modify it under the terms of the GNU General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or (at
+# your option) any later version.
+# 
+# WinRM is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
+# Public License for more details.
+# 
+# You should have received a copy of the GNU General Public License along
+# with WinRM.  If not, see <http://www.gnu.org/licenses/>.
+#############################################################################