winrm 1.8.1 → 2.0.0

data/{spec → tests/spec}/stubs/responses/wmi_error_v2.xml

@@ -1,41 +1,41 @@
-<s:Envelope xmlns:a='http://schemas.xmlsoap.org/ws/2004/08/addressing' xmlns:e='http://schemas.xmlsoap.org/ws/2004/08/eventing' xml:lang='en-US' xmlns:n='http://schemas.xmlsoap.org/ws/2004/09/enumeration' xmlns:p='http://schemas.microsoft.com/wbem/wsman/1/wsman.xsd' xmlns:s='http://www.w3.org/2003/05/soap-envelope' xmlns:w='http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd' xmlns:x='http://schemas.xmlsoap.org/ws/2004/09/transfer'>
-  <s:Header>
-    <a:Action>http://schemas.dmtf.org/wbem/wsman/1/wsman/fault</a:Action>
-    <a:MessageID>uuid:B8829021-48C3-4F27-B94B-491DAC4F29B1</a:MessageID>
-    <a:To>http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</a:To>
-  </s:Header>
-  <s:Body>
-    <s:Fault>
-      <s:Code>
-        <s:Value>s:Sender</s:Value>
-        <s:Subcode>
-          <s:Value>w:QuotaLimit</s:Value>
-        </s:Subcode>
-      </s:Code>
-      <s:Reason>
-        <s:Text xml:lang='en-US'>The WS-Management service cannot process the request. The maximum number of concurrent shells for this user has been exceeded. Close existing shells or raise the quota for this user. </s:Text>
-      </s:Reason>
-      <s:Detail>
-        <p:MSFT_WmiError b:IsCIM_Error='true' xmlns:b='http://schemas.dmtf.org/wbem/wsman/1/cimbinding.xsd' xmlns:cim='http://schemas.dmtf.org/wbem/wscim/1/common' xmlns:p='http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/MSFT_WmiError' xsi:type='p:MSFT_WmiError_Type' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'>
-          <p:CIMStatusCode xsi:type='cim:cimUnsignedInt'>27</p:CIMStatusCode>
-          <p:CIMStatusCodeDescription xsi:nil='true' xsi:type='cim:cimString'/>
-          <p:ErrorSource xsi:nil='true' xsi:type='cim:cimString'/>
-          <p:ErrorSourceFormat xsi:type='cim:cimUnsignedShort'>0</p:ErrorSourceFormat>
-          <p:ErrorType xsi:type='cim:cimUnsignedShort'>0</p:ErrorType>
-          <p:Message xsi:type='cim:cimString'>The WS-Management service cannot process the request. This user is allowed a maximum number of 30 concurrent shells, which has been exceeded. Close existing shells or raise the quota for this user. </p:Message>
-          <p:MessageID xsi:type='cim:cimString'>HRESULT 0x803381a5</p:MessageID>
-          <p:OtherErrorSourceFormat xsi:nil='true' xsi:type='cim:cimString'/>
-          <p:OtherErrorType xsi:nil='true' xsi:type='cim:cimString'/>
-          <p:OwningEntity xsi:nil='true' xsi:type='cim:cimString'/>
-          <p:PerceivedSeverity xsi:type='cim:cimUnsignedShort'>0</p:PerceivedSeverity>
-          <p:ProbableCause xsi:type='cim:cimUnsignedShort'>0</p:ProbableCause>
-          <p:ProbableCauseDescription xsi:nil='true' xsi:type='cim:cimString'/>
-          <p:error_Category xsi:type='cim:cimUnsignedInt'>30</p:error_Category>
-          <p:error_Code xsi:type='cim:cimUnsignedInt'>2150859173</p:error_Code>
-          <p:error_Type xsi:type='cim:cimString'>HRESULT</p:error_Type>
-          <p:error_WindowsErrorMessage xsi:type='cim:cimString'>The WS-Management service cannot process the request. This user is allowed a maximum number of 30 concurrent shells, which has been exceeded. Close existing shells or raise the quota for this user. </p:error_WindowsErrorMessage>
-        </p:MSFT_WmiError>
-      </s:Detail>
-    </s:Fault>
-  </s:Body>
-</s:Envelope>
+<s:Envelope xmlns:a='http://schemas.xmlsoap.org/ws/2004/08/addressing' xmlns:e='http://schemas.xmlsoap.org/ws/2004/08/eventing' xml:lang='en-US' xmlns:n='http://schemas.xmlsoap.org/ws/2004/09/enumeration' xmlns:p='http://schemas.microsoft.com/wbem/wsman/1/wsman.xsd' xmlns:s='http://www.w3.org/2003/05/soap-envelope' xmlns:w='http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd' xmlns:x='http://schemas.xmlsoap.org/ws/2004/09/transfer'>
+  <s:Header>
+    <a:Action>http://schemas.dmtf.org/wbem/wsman/1/wsman/fault</a:Action>
+    <a:MessageID>uuid:B8829021-48C3-4F27-B94B-491DAC4F29B1</a:MessageID>
+    <a:To>http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</a:To>
+  </s:Header>
+  <s:Body>
+    <s:Fault>
+      <s:Code>
+        <s:Value>s:Sender</s:Value>
+        <s:Subcode>
+          <s:Value>w:QuotaLimit</s:Value>
+        </s:Subcode>
+      </s:Code>
+      <s:Reason>
+        <s:Text xml:lang='en-US'>The WS-Management service cannot process the request. The maximum number of concurrent shells for this user has been exceeded. Close existing shells or raise the quota for this user. </s:Text>
+      </s:Reason>
+      <s:Detail>
+        <p:MSFT_WmiError b:IsCIM_Error='true' xmlns:b='http://schemas.dmtf.org/wbem/wsman/1/cimbinding.xsd' xmlns:cim='http://schemas.dmtf.org/wbem/wscim/1/common' xmlns:p='http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/MSFT_WmiError' xsi:type='p:MSFT_WmiError_Type' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'>
+          <p:CIMStatusCode xsi:type='cim:cimUnsignedInt'>27</p:CIMStatusCode>
+          <p:CIMStatusCodeDescription xsi:nil='true' xsi:type='cim:cimString'/>
+          <p:ErrorSource xsi:nil='true' xsi:type='cim:cimString'/>
+          <p:ErrorSourceFormat xsi:type='cim:cimUnsignedShort'>0</p:ErrorSourceFormat>
+          <p:ErrorType xsi:type='cim:cimUnsignedShort'>0</p:ErrorType>
+          <p:Message xsi:type='cim:cimString'>The WS-Management service cannot process the request. This user is allowed a maximum number of 30 concurrent shells, which has been exceeded. Close existing shells or raise the quota for this user. </p:Message>
+          <p:MessageID xsi:type='cim:cimString'>HRESULT 0x803381a5</p:MessageID>
+          <p:OtherErrorSourceFormat xsi:nil='true' xsi:type='cim:cimString'/>
+          <p:OtherErrorType xsi:nil='true' xsi:type='cim:cimString'/>
+          <p:OwningEntity xsi:nil='true' xsi:type='cim:cimString'/>
+          <p:PerceivedSeverity xsi:type='cim:cimUnsignedShort'>0</p:PerceivedSeverity>
+          <p:ProbableCause xsi:type='cim:cimUnsignedShort'>0</p:ProbableCause>
+          <p:ProbableCauseDescription xsi:nil='true' xsi:type='cim:cimString'/>
+          <p:error_Category xsi:type='cim:cimUnsignedInt'>30</p:error_Category>
+          <p:error_Code xsi:type='cim:cimUnsignedInt'>2150859173</p:error_Code>
+          <p:error_Type xsi:type='cim:cimString'>HRESULT</p:error_Type>
+          <p:error_WindowsErrorMessage xsi:type='cim:cimString'>The WS-Management service cannot process the request. This user is allowed a maximum number of 30 concurrent shells, which has been exceeded. Close existing shells or raise the quota for this user. </p:error_WindowsErrorMessage>
+        </p:MSFT_WmiError>
+      </s:Detail>
+    </s:Fault>
+  </s:Body>
+</s:Envelope>

data/tests/spec/wsmv/cleanup_command_spec.rb

@@ -0,0 +1,22 @@
+# encoding: UTF-8
+
+require 'winrm/wsmv/cleanup_command'
+
+describe WinRM::WSMV::CleanupCommand do
+  context 'default session options' do
+    let(:cmd_opts) do
+      {
+        shell_id: 'F4A2622B-B842-4EB8-8A78-0225C8A993DF',
+        command_id: 'A2A2622B-B842-4EB8-8A78-0225C8A993DF'
+      }
+    end
+    subject { described_class.new(default_connection_opts, cmd_opts) }
+    let(:xml) { subject.build }
+    it 'creates a well formed message' do
+      expect(xml).to include('<w:OperationTimeout>PT60S</w:OperationTimeout>')
+      expect(xml).to include('<rsp:Signal CommandId="A2A2622B-B842-4EB8-8A78-0225C8A993DF">' \
+        '<rsp:Code>http://schemas.microsoft.com/wbem/wsman/1/windows/shell/signal/terminate' \
+        '</rsp:Code></rsp:Signal>')
+    end
+  end
+end

data/tests/spec/wsmv/close_shell_spec.rb

@@ -0,0 +1,17 @@
+# encoding: UTF-8
+
+require 'winrm/wsmv/close_shell'
+
+describe WinRM::WSMV::CloseShell do
+  context 'default session options' do
+    subject do
+      described_class.new(default_connection_opts, shell_id: 'F4A2622B-B842-4EB8-8A78-0225C8A993DF')
+    end
+    let(:xml) { subject.build }
+    it 'creates a well formed message' do
+      expect(xml).to include('<w:OperationTimeout>PT60S</w:OperationTimeout>')
+      expect(xml).to include('<a:Action mustUnderstand="true">' \
+        'http://schemas.xmlsoap.org/ws/2004/09/transfer/Delete</a:Action>')
+    end
+  end
+end

data/{spec → tests/spec/wsmv}/command_output_decoder_spec.rb

@@ -1,37 +1,37 @@
-# encoding: UTF-8
-
-require 'winrm/command_output_decoder'
-
-describe WinRM::CommandOutputDecoder, unit: true do
-  let(:raw_output_with_bom) do
-    '77u/' \
-    'ICAgQ29ubmVjdGlvbi1zcGVjaWZpYyBETlMgU3VmZml4ICAuIDogDQogICBMaW5rLWxvY2FsIElQdjYgQWRkcmVzcyA' \
-    'uIC4gLiAuIC4gOiBmZTgwOjo5MTFkOjE2OTQ6NTcwNDo1YjI5JTEyDQogICBJUHY0IEFkZHJlc3MuIC4gLiAuIC4gLi' \
-    'AuIC4gLiAuIC4gOiAxMC4wLjIuMTUNCiAgIFN1Ym5ldCBNYXNrIC4gLiAuIC4gLiAuIC4gLiAuIC4gLiA6IDI1NS4yN' \
-    'TUuMjU1LjANCiAgIERlZmF1bHQgR2F0ZXdheSAuIC4gLiAuIC4gLiAuIC4gLiA6IDEwLjAuMi4yDQoNClR1bm5lbCBh' \
-    'ZGFwdGVyIGlzYXRhcC57RjBENTY2RDgtNzlCMS00QUYwLUJENUQtMkM5RkVEOEI3MTE3fToNCg0KICAgTWVkaWEgU3R' \
-    'hdGUgLiAuIC4gLiAuIC4gLiAuIC4gLiAuIDogTWVkaWEgZGlzY29ubmVjdGVkDQogICBDb25uZWN0aW9uLXNwZWNpZm' \
-    'ljIEROUyBTdWZmaXggIC4gOiANCg0KVHVubmVsIGFkYXB0ZXIgVGVyZWRvIFR1bm5lbGluZyBQc2V1ZG8tSW50ZXJmY' \
-    'WNlOg0KDQogICBDb25uZWN0aW9uLXNwZWNpZmljIEROUyBTdWZmaXggIC4gOiANCiAgIElQdjYgQWRkcmVzcy4gLiAu' \
-    'IC4gLiAuIC4gLiAuIC4gLiA6IDIwMDE6MDo5ZDM4OjZhYmQ6NGJiOjI4YjU6ZjVmZjpmZGYwDQogICBMaW5rLWxvY2F' \
-    'sIElQdjYgQWRkcmVzcyAuIC4gLiAuIC4gOiBmZTgwOjo0YmI6MjhiNTpmNWZmOmZkZjAlMTQNCiAgIERlZmF1bHQgR2' \
-    'F0ZXdheSAuIC4gLiAuIC4gLiAuIC4gLiA6IDo6DQo='
-  end
-  let(:expected) do
-    "   Connection-specific DNS Suffix  . : \r\n   Link-local IPv6 Address . . . . . : fe80::911" \
-    "d:1694:5704:5b29%12\r\n   IPv4 Address. . . . . . . . . . . : 10.0.2.15\r\n   Subnet Mask ." \
-    " . . . . . . . . . . : 255.255.255.0\r\n   Default Gateway . . . . . . . . . : 10.0.2.2\r\n" \
-    "\r\nTunnel adapter isatap.{F0D566D8-79B1-4AF0-BD5D-2C9FED8B7117}:\r\n\r\n   Media State . ." \
-    " . . . . . . . . . : Media disconnected\r\n   Connection-specific DNS Suffix  . : \r\n\r\nT" \
-    "unnel adapter Teredo Tunneling Pseudo-Interface:\r\n\r\n   Connection-specific DNS Suffix  " \
-    ". : \r\n   IPv6 Address. . . . . . . . . . . : 2001:0:9d38:6abd:4bb:28b5:f5ff:fdf0\r\n   Li" \
-    "nk-local IPv6 Address . . . . . : fe80::4bb:28b5:f5ff:fdf0%14\r\n   Default Gateway . . . ." \
-    " . . . . . : ::\r\n"
-  end
-  subject { described_class.new }
-  context 'valid UTF-8 raw output' do
-    it 'decodes' do
-      expect(subject.decode(raw_output_with_bom)).to eq(expected)
-    end
-  end
-end
+# encoding: UTF-8
+
+require 'winrm/wsmv/command_output_decoder'
+
+describe WinRM::WSMV::CommandOutputDecoder do
+  let(:raw_output_with_bom) do
+    '77u/' \
+    'ICAgQ29ubmVjdGlvbi1zcGVjaWZpYyBETlMgU3VmZml4ICAuIDogDQogICBMaW5rLWxvY2FsIElQdjYgQWRkcmVzcyA' \
+    'uIC4gLiAuIC4gOiBmZTgwOjo5MTFkOjE2OTQ6NTcwNDo1YjI5JTEyDQogICBJUHY0IEFkZHJlc3MuIC4gLiAuIC4gLi' \
+    'AuIC4gLiAuIC4gOiAxMC4wLjIuMTUNCiAgIFN1Ym5ldCBNYXNrIC4gLiAuIC4gLiAuIC4gLiAuIC4gLiA6IDI1NS4yN' \
+    'TUuMjU1LjANCiAgIERlZmF1bHQgR2F0ZXdheSAuIC4gLiAuIC4gLiAuIC4gLiA6IDEwLjAuMi4yDQoNClR1bm5lbCBh' \
+    'ZGFwdGVyIGlzYXRhcC57RjBENTY2RDgtNzlCMS00QUYwLUJENUQtMkM5RkVEOEI3MTE3fToNCg0KICAgTWVkaWEgU3R' \
+    'hdGUgLiAuIC4gLiAuIC4gLiAuIC4gLiAuIDogTWVkaWEgZGlzY29ubmVjdGVkDQogICBDb25uZWN0aW9uLXNwZWNpZm' \
+    'ljIEROUyBTdWZmaXggIC4gOiANCg0KVHVubmVsIGFkYXB0ZXIgVGVyZWRvIFR1bm5lbGluZyBQc2V1ZG8tSW50ZXJmY' \
+    'WNlOg0KDQogICBDb25uZWN0aW9uLXNwZWNpZmljIEROUyBTdWZmaXggIC4gOiANCiAgIElQdjYgQWRkcmVzcy4gLiAu' \
+    'IC4gLiAuIC4gLiAuIC4gLiA6IDIwMDE6MDo5ZDM4OjZhYmQ6NGJiOjI4YjU6ZjVmZjpmZGYwDQogICBMaW5rLWxvY2F' \
+    'sIElQdjYgQWRkcmVzcyAuIC4gLiAuIC4gOiBmZTgwOjo0YmI6MjhiNTpmNWZmOmZkZjAlMTQNCiAgIERlZmF1bHQgR2' \
+    'F0ZXdheSAuIC4gLiAuIC4gLiAuIC4gLiA6IDo6DQo='
+  end
+  let(:expected) do
+    "   Connection-specific DNS Suffix  . : \r\n   Link-local IPv6 Address . . . . . : fe80::911" \
+    "d:1694:5704:5b29%12\r\n   IPv4 Address. . . . . . . . . . . : 10.0.2.15\r\n   Subnet Mask ." \
+    " . . . . . . . . . . : 255.255.255.0\r\n   Default Gateway . . . . . . . . . : 10.0.2.2\r\n" \
+    "\r\nTunnel adapter isatap.{F0D566D8-79B1-4AF0-BD5D-2C9FED8B7117}:\r\n\r\n   Media State . ." \
+    " . . . . . . . . . : Media disconnected\r\n   Connection-specific DNS Suffix  . : \r\n\r\nT" \
+    "unnel adapter Teredo Tunneling Pseudo-Interface:\r\n\r\n   Connection-specific DNS Suffix  " \
+    ". : \r\n   IPv6 Address. . . . . . . . . . . : 2001:0:9d38:6abd:4bb:28b5:f5ff:fdf0\r\n   Li" \
+    "nk-local IPv6 Address . . . . . : fe80::4bb:28b5:f5ff:fdf0%14\r\n   Default Gateway . . . ." \
+    " . . . . . : ::\r\n"
+  end
+  subject { described_class.new }
+  context 'valid UTF-8 raw output' do
+    it 'decodes' do
+      expect(subject.decode(raw_output_with_bom)).to eq(expected)
+    end
+  end
+end

data/tests/spec/wsmv/command_output_spec.rb

@@ -0,0 +1,45 @@
+# encoding: UTF-8
+
+require 'winrm/wsmv/command_output'
+require 'winrm/wsmv/header'
+
+describe WinRM::WSMV::CommandOutput do
+  context 'default session options' do
+    let(:cmd_out_opts) do
+      {
+        shell_id: 'F4A2622B-B842-4EB8-8A78-0225C8A993DF',
+        command_id: 'A2A2622B-B842-4EB8-8A78-0225C8A993DF'
+      }
+    end
+    subject { described_class.new(default_connection_opts, cmd_out_opts) }
+    let(:xml) { subject.build }
+    it 'creates a well formed message' do
+      expect(xml).to include('<w:OperationTimeout>PT60S</w:OperationTimeout>')
+      expect(xml).to include('<w:Option Name="WSMAN_CMDSHELL_OPTION_KEEPALIVE">TRUE</w:Option>')
+      expect(xml).to include('w:ResourceURI mustUnderstand="true">' \
+        'http://schemas.microsoft.com/wbem/wsman/1/windows/shell/cmd</w:ResourceURI>')
+      expect(xml).to include('<rsp:DesiredStream ' \
+        'CommandId="A2A2622B-B842-4EB8-8A78-0225C8A993DF">stdout stderr</rsp:DesiredStream>')
+    end
+  end
+  context 'powershell' do
+    let(:cmd_out_opts) do
+      {
+        shell_id: 'F4A2622B-B842-4EB8-8A78-0225C8A993DF',
+        command_id: 'A2A2622B-B842-4EB8-8A78-0225C8A993DF',
+        shell_uri: WinRM::WSMV::Header::RESOURCE_URI_POWERSHELL,
+        out_streams: %w(stdout)
+      }
+    end
+    subject { described_class.new(default_connection_opts, cmd_out_opts) }
+    let(:xml) { subject.build }
+    it 'creates a well formed message' do
+      expect(xml).to include('<w:OperationTimeout>PT60S</w:OperationTimeout>')
+      expect(xml).to include('<w:Option Name="WSMAN_CMDSHELL_OPTION_KEEPALIVE">TRUE</w:Option>')
+      expect(xml).to include('w:ResourceURI mustUnderstand="true">' \
+        'http://schemas.microsoft.com/powershell/Microsoft.PowerShell</w:ResourceURI>')
+      expect(xml).to include('<rsp:DesiredStream ' \
+        'CommandId="A2A2622B-B842-4EB8-8A78-0225C8A993DF">stdout</rsp:DesiredStream>')
+    end
+  end
+end

data/tests/spec/wsmv/command_spec.rb

@@ -0,0 +1,19 @@
+# encoding: UTF-8
+
+require 'winrm/wsmv/command'
+
+describe WinRM::WSMV::Command do
+  context 'default session options' do
+    let(:cmd_opts) do
+      {
+        shell_id: 'D5A2622B-B842-4EB8-8A78-0225C8A993DF',
+        command: 'ipconfig'
+      }
+    end
+    subject { described_class.new(default_connection_opts, cmd_opts) }
+    let(:xml) { subject.build }
+    it 'creates a well formed message' do
+      expect(xml).to include('<w:OperationTimeout>PT60S</w:OperationTimeout>')
+    end
+  end
+end

data/tests/spec/wsmv/configuration_spec.rb

@@ -0,0 +1,17 @@
+# encoding: UTF-8
+
+require 'winrm/wsmv/configuration'
+
+describe WinRM::WSMV::Configuration do
+  subject do
+    described_class.new(default_connection_opts)
+  end
+  let(:xml) { subject.build }
+  it 'creates a well formed message' do
+    expect(xml).to include('<w:OperationTimeout>PT60S</w:OperationTimeout>')
+    expect(xml).to include('<a:Action mustUnderstand="true">' \
+      'http://schemas.xmlsoap.org/ws/2004/09/transfer/Get</a:Action>')
+    expect(xml).to include('w:ResourceURI mustUnderstand="true">' \
+      'http://schemas.microsoft.com/wbem/wsman/1/config</w:ResourceURI>')
+  end
+end

data/tests/spec/wsmv/create_pipeline_spec.rb

@@ -0,0 +1,31 @@
+# encoding: UTF-8
+
+require 'winrm/wsmv/create_pipeline'
+
+describe WinRM::WSMV::CreatePipeline do
+  context 'default session options' do
+    let(:shell_id) { 'D5A2622B-B842-4EB8-8A78-0225C8A993DF' }
+    let(:command_id) { 'D5A2622B-B842-4EB8-8A78-0225C8A993DF' }
+    let(:fragment) { WinRM::PSRP::Fragment.new(0, [1, 2, 3]) }
+    let(:pipeline) { Base64.strict_encode64(fragment.bytes.pack('C*')) }
+
+    subject do
+      WinRM::WSMV::CreatePipeline.new(
+        default_connection_opts,
+        shell_id,
+        command_id,
+        fragment
+      )
+    end
+    let(:xml) { subject.build }
+    it 'creates a well formed message' do
+      expect(xml).to include('<w:OperationTimeout>PT60S</w:OperationTimeout>')
+      expect(xml).to include(
+        '<w:SelectorSet><w:Selector Name="ShellId">' \
+        "#{shell_id}</w:Selector></w:SelectorSet>")
+      expect(xml).to include("<rsp:CommandLine CommandId=\"#{command_id}\">")
+      expect(xml).to include('<rsp:Command>Invoke-Expression</rsp:Command>')
+      expect(xml).to include("<rsp:Arguments>#{pipeline}</rsp:Arguments>")
+    end
+  end
+end

data/tests/spec/wsmv/create_shell_spec.rb

@@ -0,0 +1,38 @@
+# encoding: UTF-8
+
+require 'winrm/wsmv/create_shell'
+
+describe WinRM::WSMV::CreateShell do
+  context 'default session options' do
+    subject { described_class.new(default_connection_opts) }
+    let(:xml) { subject.build }
+    it 'creates a well formed message' do
+      expect(xml).to include('<w:OperationTimeout>PT60S</w:OperationTimeout>')
+      expect(xml).to include('<w:Locale xml:lang="en-US" mustUnderstand="false"/>')
+      expect(xml).to include('<p:DataLocale xml:lang="en-US" mustUnderstand="false"/>')
+      expect(xml).to include(
+        '<p:SessionId mustUnderstand="false">' \
+        'uuid:05A2622B-B842-4EB8-8A78-0225C8A993DF</p:SessionId>')
+      expect(xml).to include('<w:MaxEnvelopeSize mustUnderstand="true">153600</w:MaxEnvelopeSize>')
+      expect(xml).to include('<a:To>http://localhost:5985/wsman</a:To>')
+      expect(xml).to include('<rsp:InputStreams>stdin</rsp:InputStreams>')
+      expect(xml).to include('<rsp:OutputStreams>stdout stderr</rsp:OutputStreams>')
+      expect(xml).to include(
+        '<w:ResourceURI mustUnderstand="true">' \
+        'http://schemas.microsoft.com/wbem/wsman/1/windows/shell/cmd</w:ResourceURI>')
+    end
+    context 'shell options w/env vars' do
+      let(:shell_opts) do
+        {
+          env_vars: { 'FOO' => 'BAR' }
+        }
+      end
+      subject { described_class.new(default_connection_opts, shell_opts) }
+      let(:xml) { subject.build }
+      it 'includes environemt vars' do
+        expect(xml).to include(
+          '<rsp:Environment><rsp:Variable Name="FOO">BAR</rsp:Variable></rsp:Environment>')
+      end
+    end
+  end
+end

data/tests/spec/wsmv/init_runspace_pool_spec.rb

@@ -0,0 +1,36 @@
+# encoding: UTF-8
+
+require 'winrm/wsmv/init_runspace_pool'
+
+describe WinRM::WSMV::InitRunspacePool do
+  context 'default session options' do
+    let(:shell_id) { SecureRandom.uuid.to_s.upcase }
+    let(:payload) { 'blah'.bytes }
+
+    subject { described_class.new(default_connection_opts, shell_id, payload) }
+
+    it 'creates a well formed message' do
+      xml = subject.build
+      expect(xml).to include('<w:OperationTimeout>PT60S</w:OperationTimeout>')
+      expect(xml).to include('<w:Locale xml:lang="en-US" mustUnderstand="false"/>')
+      expect(xml).to include('<p:DataLocale xml:lang="en-US" mustUnderstand="false"/>')
+      expect(xml).to include(
+        '<p:SessionId mustUnderstand="false">' \
+        'uuid:05A2622B-B842-4EB8-8A78-0225C8A993DF</p:SessionId>')
+      expect(xml).to include('<w:MaxEnvelopeSize mustUnderstand="true">153600</w:MaxEnvelopeSize>')
+      expect(xml).to include('<a:To>http://localhost:5985/wsman</a:To>')
+      expect(xml).to include(
+        '<w:OptionSet env:mustUnderstand="true">' \
+        '<w:Option Name="protocolversion" MustComply="true">2.3</w:Option></w:OptionSet>')
+      expect(xml).to include('<rsp:InputStreams>stdin pr</rsp:InputStreams>')
+      expect(xml).to include('<rsp:OutputStreams>stdout</rsp:OutputStreams>')
+      expect(xml).to include("<rsp:Shell ShellId=\"#{subject.shell_id}\">")
+      expect(xml).to include(
+        '<w:ResourceURI mustUnderstand="true">' \
+        'http://schemas.microsoft.com/powershell/Microsoft.PowerShell')
+      expect(xml).to include(
+        '<creationXml xmlns="http://schemas.microsoft.com/powershell">' \
+        "#{Base64.strict_encode64(payload.pack('C*'))}</creationXml>")
+    end
+  end
+end

data/tests/spec/wsmv/keep_alive_spec.rb

@@ -0,0 +1,21 @@
+# encoding: UTF-8
+
+require 'winrm/wsmv/keep_alive'
+
+describe WinRM::WSMV::KeepAlive do
+  context 'default session options' do
+    let(:shell_id) { 'F4A2622B-B842-4EB8-8A78-0225C8A993DF' }
+    subject { described_class.new(default_connection_opts, shell_id) }
+    let(:xml) { subject.build }
+    it 'creates a well formed message' do
+      expect(xml).to include('<w:OperationTimeout>PT60S</w:OperationTimeout>')
+      expect(xml).to include(
+        '<w:OptionSet><w:Option Name="WSMAN_CMDSHELL_OPTION_KEEPALIVE">' \
+        'TRUE</w:Option></w:OptionSet>')
+      expect(xml).to include(
+        '<w:SelectorSet><w:Selector Name="ShellId">' \
+        "#{shell_id}</w:Selector></w:SelectorSet>")
+      expect(xml).to include('<rsp:DesiredStream>stdout</rsp:DesiredStream>')
+    end
+  end
+end

data/tests/spec/wsmv/receive_response_reader_spec.rb

@@ -0,0 +1,123 @@
+# encoding: UTF-8
+
+require 'winrm/wsmv/receive_response_reader'
+
+describe WinRM::WSMV::ReceiveResponseReader do
+  let(:shell_id) { 'F4A2622B-B842-4EB8-8A78-0225C8A993DF' }
+  let(:command_id) { 'A2A2622B-B842-4EB8-8A78-0225C8A993DF' }
+  let(:output_message) { double('output_message', build: 'output_message') }
+  let(:test_data_xml_template) do
+    ERB.new(stubbed_response('get_command_output_response.xml.erb'))
+  end
+  let(:test_data_xml_template_not_done) do
+    ERB.new(stubbed_response('get_command_output_response_not_done.xml.erb'))
+  end
+  let(:transport) do
+    {}
+  end
+
+  subject do
+    described_class.new(
+      transport,
+      Logging.logger['test']
+    )
+  end
+
+  describe '#read_output' do
+    context 'response doc stdout with invalid UTF-8 characters, issue 184' do
+      let(:test_data_stdout) { 'ffff' } # Base64-decodes to '}\xF7\xDF', an invalid sequence
+      let(:test_data_stderr) { '' }
+      let(:test_data_xml)    { test_data_xml_template.result(binding) }
+
+      before do
+        allow(transport).to receive(:send_request).and_return(
+          REXML::Document.new(test_data_xml)
+        )
+      end
+
+      it 'does not raise an ArgumentError: invalid byte sequence in UTF-8' do
+        begin
+          expect(
+            subject.read_output(output_message)
+          ).not_to raise_error
+        rescue RSpec::Expectations::ExpectationNotMetError => e
+          expect(e.message).not_to include 'ArgumentError'
+        end
+      end
+
+      it 'does not have an empty stdout' do
+        expect(
+          subject.read_output(output_message).stdout
+        ).not_to be_empty
+      end
+    end
+
+    context 'response doc stdout with valid UTF-8' do
+      let(:test_data_raw)    { '✓1234-äöü' }
+      let(:test_data_stdout) { Base64.encode64(test_data_raw) }
+      let(:test_data_stderr) { '' }
+      let(:test_data_xml)    { test_data_xml_template.result(binding) }
+
+      before do
+        allow(transport).to receive(:send_request).and_return(
+          REXML::Document.new(test_data_xml)
+        )
+      end
+
+      it 'decodes to match input data' do
+        expect(
+          subject.read_output(output_message).stdout
+        ).to eq(test_data_raw)
+      end
+    end
+  end
+
+  describe '#read_response' do
+    context 'do not wait for done state' do
+      let(:test_data_raw) { 'output text' }
+      let(:test_error_raw) { 'error text' }
+      let(:test_data_stdout) { Base64.encode64(test_data_raw) }
+      let(:test_data_stderr) { Base64.encode64(test_error_raw) }
+      let(:test_data_xml)    { test_data_xml_template.result(binding) }
+
+      before do
+        allow(transport).to receive(:send_request).and_return(
+          REXML::Document.new(test_data_xml)
+        ).once
+      end
+
+      it 'yields stream and document' do
+        subject.read_response(output_message) do |stream, doc|
+          expect(stream[:text]).to eq(test_data_stdout) if stream[:type] == :stdout
+          expect(stream[:text]).to eq(test_data_stderr) if stream[:type] == :stderr
+          expect(doc.to_s).to eq(REXML::Document.new(test_data_xml).to_s)
+        end
+      end
+    end
+
+    context 'wait for done state' do
+      let(:test_data_raw) { 'output text' }
+      let(:test_error_raw) { 'error text' }
+      let(:test_data_stdout) { Base64.encode64(test_data_raw) }
+      let(:test_data_stderr) { Base64.encode64(test_error_raw) }
+      let(:test_data_xml_not_done) { test_data_xml_template_not_done.result(binding) }
+      let(:test_data_xml_done) { test_data_xml_template.result(binding) }
+
+      it 'yields streams and both documents' do
+        allow(transport).to receive(:send_request).and_return(
+          REXML::Document.new(test_data_xml_not_done),
+          REXML::Document.new(test_data_xml_done)
+        )
+        times = 1
+
+        subject.read_response(output_message, true) do |stream, doc|
+          expect(stream[:text]).to eq(test_data_stdout) if stream[:type] == :stdout
+          expect(stream[:text]).to eq(test_data_stderr) if stream[:type] == :stderr
+          expect(doc.to_s).to eq(REXML::Document.new(test_data_xml_not_done).to_s) if times == 1
+          expect(doc.to_s).to eq(REXML::Document.new(test_data_xml_done).to_s) if times > 2
+          times += 1
+        end
+      end
+    end
+  end
+end