winrm-elevated 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2940150c1108b6135ff4712c64ad169d70fcffa2
-  data.tar.gz: 42efa9e3662deda528e95fd9136de461a5549d6f
+  metadata.gz: a0420d9b98e357f1cf14dbd04f4955b7ae22fc4e
+  data.tar.gz: a90fd7ad69ebd4a66061d06ffa44559ed42c3729
 SHA512:
-  metadata.gz: 1cbcd05d2a81bde6948710277eeb585a3056025be7937654e986e8e75bd778812c8e4ad293dd91cd0e344e70b4ae7874e409774f7326912248458c7a8966a364
-  data.tar.gz: 66cf31d2b965d1ff95390e1439008e120032712cc612196c48e4d34c84d12225f0e513d0cb4c4b7d55d490974c4c7706085c422793a9659eb738be9afd1b6b47
+  metadata.gz: 1430d0e0c73f91c58b0235079bd94ddb2dea3a206eb2adae5154c3bdbd258e5abec7b9e86ffc4cb6492cb51188fcb297c08c96b0a613ce5293c8e910d54a724e
+  data.tar.gz: 0e80a6e1d4110639c9bb9529d16c782c49092c924ea70f97c78b605b9d193f0b8ba69562752eab7bdec617ad031b5979442bc7517034515b1396ca984971d448

data/README.md

@@ -1,6 +1,8 @@
 # Runs PowerShell commands as elevated over Windows Remote Management (WinRM) via a scheduled task
 [![Gem Version](https://badge.fury.io/rb/winrm-elevated.svg)](http://badge.fury.io/rb/winrm-elevated)
 
+This gem allows you to break out of the magical WinRM constraints thus allowing to reach out to network shares and even install Windows updates, .NET, SQL Server etc.
+
 ## Running commands elevated
 ```ruby
 require 'winrm'
@@ -12,6 +14,16 @@ result = elevated_runner.powershell_elevated('dir', 'Administrator', 'password')
 puts "Std out: #{result.output}"
 ```
 
+## How does it work?
+
+The gem works by creating a new logon session local to the Windows box by using a scheduled task. After this point WinRM is just used to read output from the scheduled task via a log file.
+
+1. The command you'd like to run outside the WinRM context is encoded and placed inside the PowerShell script elevated_shell.ps1.
+2. The script is uploaded to the machine over WinRM.
+3. The script is executed over WinRM and the script does the following:
+  1. Scheduled task is created which will execute your command and redirect stdout and stderr to a location known by elevated_shell.ps1.
+  2. The scheduled task is executed.
+  3. elevated_shell.ps1 polls the stdout and stderr log files and writes them back to WinRM. The script continues in this loop until the scheduled task is complete.
 
 ## Troubleshooting
 

data/VERSION

@@ -1 +1 @@
-0.1.0
+0.2.0

data/changelog.md

@@ -1,5 +1,8 @@
 # WinRM-Elevated Gem Changelog
 
+# 0.2.0
+- [Only upload the elevated runner script once per winrm session](https://github.com/WinRb/winrm-elevated/pull/3)
+- Bump WinRM (1.5) and WinRM-fs (0.3.0) gem constraints
+
 # 0.1.0
 - Initial Release
-

data/lib/winrm-elevated/runner.rb

@@ -27,6 +27,7 @@ module WinRM
         @winrm_service = winrm_service
         @winrm_file_manager = WinRM::FS::FileManager.new(winrm_service)
         @elevated_shell_path = 'c:/windows/temp/winrm-elevated-shell.ps1'
+        @uploaded            = nil
       end
 
       # Run a command or PowerShell script elevated without any of the
@@ -49,18 +50,24 @@ module WinRM
       private
 
       def upload_elevated_shell_wrapper_script
-        file = Tempfile.new(['winrm-elevated-shell', 'ps1'])
-        begin
-          file.write(elevated_shell_script_content)
-          file.fsync
-          file.close
-          @winrm_file_manager.upload(file.path, @elevated_shell_path)
-        ensure
-          file.close
-          file.unlink
+        return if @uploaded
+        with_temp_file do |temp_file|
+          @winrm_file_manager.upload(temp_file, @elevated_shell_path)
+          @uploaded = true
         end
       end
 
+      def with_temp_file
+        file = Tempfile.new(['winrm-elevated-shell', 'ps1'])
+        file.write(elevated_shell_script_content)
+        file.fsync
+        file.close
+        yield file.path
+      ensure
+        file.close
+        file.unlink
+      end
+
       def elevated_shell_script_content
         IO.read(File.expand_path('../scripts/elevated_shell.ps1', __FILE__))
       end

data/winrm-elevated.gemspec

@@ -25,8 +25,8 @@ Gem::Specification.new do |s|
   s.extra_rdoc_files = %w(README.md LICENSE)
 
   s.required_ruby_version = '>= 1.9.0'
-  s.add_runtime_dependency 'winrm', '~> 1.3'
-  s.add_runtime_dependency 'winrm-fs', '~> 0.2.2'
+  s.add_runtime_dependency 'winrm', '~> 1.5'
+  s.add_runtime_dependency 'winrm-fs', '~> 0.3.0'
   s.add_development_dependency 'rspec', '~> 3.2'
   s.add_development_dependency 'rake', '~> 10.3'
   s.add_development_dependency 'rubocop', '~> 0.28'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: winrm-elevated
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Shawn Neal
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-10-15 00:00:00.000000000 Z
+date: 2016-03-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: winrm
@@ -16,28 +16,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: '1.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: '1.5'
 - !ruby/object:Gem::Dependency
   name: winrm-fs
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.2
+        version: 0.3.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.2
+        version: 0.3.0
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -132,7 +132,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.5
+rubygems_version: 2.5.2
 signing_key: 
 specification_version: 4
 summary: Ruby library for running commands as elevated