winrm 2.1.0 → 2.1.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (127) hide show
  1. checksums.yaml +4 -4
  2. data/.gitignore +10 -10
  3. data/.rubocop.yml +26 -26
  4. data/.travis.yml +11 -11
  5. data/Gemfile +3 -3
  6. data/README.md +263 -260
  7. data/Rakefile +34 -34
  8. data/Vagrantfile +6 -6
  9. data/WinrmAppveyor.psm1 +31 -31
  10. data/appveyor.yml +51 -51
  11. data/changelog.md +107 -104
  12. data/lib/winrm.rb +39 -39
  13. data/lib/winrm/connection.rb +83 -83
  14. data/lib/winrm/connection_opts.rb +91 -91
  15. data/lib/winrm/exceptions.rb +76 -76
  16. data/lib/winrm/http/response_handler.rb +96 -96
  17. data/lib/winrm/http/transport.rb +424 -424
  18. data/lib/winrm/http/transport_factory.rb +68 -68
  19. data/lib/winrm/output.rb +59 -59
  20. data/lib/winrm/psrp/create_pipeline.xml.erb +167 -167
  21. data/lib/winrm/psrp/fragment.rb +70 -70
  22. data/lib/winrm/psrp/init_runspace_pool.xml.erb +224 -224
  23. data/lib/winrm/psrp/message.rb +130 -130
  24. data/lib/winrm/psrp/message_data.rb +42 -42
  25. data/lib/winrm/psrp/message_data/base.rb +49 -49
  26. data/lib/winrm/psrp/message_data/error_record.rb +68 -68
  27. data/lib/winrm/psrp/message_data/pipeline_host_call.rb +32 -32
  28. data/lib/winrm/psrp/message_data/pipeline_output.rb +54 -49
  29. data/lib/winrm/psrp/message_data/pipeline_state.rb +40 -40
  30. data/lib/winrm/psrp/message_data/runspacepool_host_call.rb +32 -32
  31. data/lib/winrm/psrp/message_data/runspacepool_state.rb +39 -39
  32. data/lib/winrm/psrp/message_data/session_capability.rb +36 -36
  33. data/lib/winrm/psrp/message_defragmenter.rb +62 -62
  34. data/lib/winrm/psrp/message_factory.rb +75 -75
  35. data/lib/winrm/psrp/message_fragmenter.rb +60 -60
  36. data/lib/winrm/psrp/powershell_output_decoder.rb +144 -139
  37. data/lib/winrm/psrp/receive_response_reader.rb +97 -97
  38. data/lib/winrm/psrp/session_capability.xml.erb +7 -7
  39. data/lib/winrm/psrp/uuid.rb +40 -40
  40. data/lib/winrm/shells/base.rb +180 -180
  41. data/lib/winrm/shells/cmd.rb +65 -65
  42. data/lib/winrm/shells/power_shell.rb +202 -202
  43. data/lib/winrm/shells/retryable.rb +45 -45
  44. data/lib/winrm/shells/shell_factory.rb +58 -58
  45. data/lib/winrm/version.rb +7 -7
  46. data/lib/winrm/wsmv/base.rb +59 -59
  47. data/lib/winrm/wsmv/cleanup_command.rb +61 -61
  48. data/lib/winrm/wsmv/close_shell.rb +50 -50
  49. data/lib/winrm/wsmv/command.rb +101 -101
  50. data/lib/winrm/wsmv/command_output.rb +76 -76
  51. data/lib/winrm/wsmv/command_output_decoder.rb +55 -55
  52. data/lib/winrm/wsmv/configuration.rb +46 -46
  53. data/lib/winrm/wsmv/create_pipeline.rb +66 -66
  54. data/lib/winrm/wsmv/create_shell.rb +119 -119
  55. data/lib/winrm/wsmv/header.rb +203 -203
  56. data/lib/winrm/wsmv/init_runspace_pool.rb +95 -95
  57. data/lib/winrm/wsmv/iso8601_duration.rb +60 -60
  58. data/lib/winrm/wsmv/keep_alive.rb +68 -68
  59. data/lib/winrm/wsmv/receive_response_reader.rb +126 -126
  60. data/lib/winrm/wsmv/send_data.rb +68 -68
  61. data/lib/winrm/wsmv/soap.rb +51 -51
  62. data/lib/winrm/wsmv/wql_query.rb +79 -79
  63. data/lib/winrm/wsmv/write_stdin.rb +88 -88
  64. data/tests/integration/auth_timeout_spec.rb +18 -18
  65. data/tests/integration/cmd_spec.rb +131 -131
  66. data/tests/integration/config-example.yml +16 -16
  67. data/tests/integration/issue_59_spec.rb +26 -26
  68. data/tests/integration/powershell_spec.rb +165 -165
  69. data/tests/integration/spec_helper.rb +65 -65
  70. data/tests/integration/transport_spec.rb +99 -99
  71. data/tests/integration/wql_spec.rb +16 -16
  72. data/tests/matchers.rb +60 -60
  73. data/tests/spec/configuration_spec.rb +184 -184
  74. data/tests/spec/connection_spec.rb +39 -39
  75. data/tests/spec/exception_spec.rb +50 -50
  76. data/tests/spec/http/transport_factory_spec.rb +68 -68
  77. data/tests/spec/http/transport_spec.rb +44 -44
  78. data/tests/spec/output_spec.rb +127 -127
  79. data/tests/spec/psrp/fragment_spec.rb +62 -62
  80. data/tests/spec/psrp/message_data/base_spec.rb +13 -13
  81. data/tests/spec/psrp/message_data/error_record_spec.rb +41 -41
  82. data/tests/spec/psrp/message_data/pipeline_host_call_spec.rb +25 -25
  83. data/tests/spec/psrp/message_data/pipeline_output_spec.rb +32 -32
  84. data/tests/spec/psrp/message_data/pipeline_state_spec.rb +40 -40
  85. data/tests/spec/psrp/message_data/runspace_pool_host_call_spec.rb +25 -25
  86. data/tests/spec/psrp/message_data/runspacepool_state_spec.rb +16 -16
  87. data/tests/spec/psrp/message_data/session_capability_spec.rb +30 -30
  88. data/tests/spec/psrp/message_data_spec.rb +35 -35
  89. data/tests/spec/psrp/message_defragmenter_spec.rb +47 -47
  90. data/tests/spec/psrp/message_fragmenter_spec.rb +105 -105
  91. data/tests/spec/psrp/powershell_output_decoder_spec.rb +100 -100
  92. data/tests/spec/psrp/psrp_message_spec.rb +70 -70
  93. data/tests/spec/psrp/recieve_response_reader_spec.rb +172 -172
  94. data/tests/spec/psrp/uuid_spec.rb +28 -28
  95. data/tests/spec/response_handler_spec.rb +61 -61
  96. data/tests/spec/shells/base_spec.rb +202 -202
  97. data/tests/spec/shells/cmd_spec.rb +75 -75
  98. data/tests/spec/shells/powershell_spec.rb +175 -175
  99. data/tests/spec/spec_helper.rb +47 -47
  100. data/tests/spec/stubs/clixml/error_record.xml.erb +84 -84
  101. data/tests/spec/stubs/clixml/pipeline_state.xml.erb +88 -88
  102. data/tests/spec/stubs/responses/get_command_output_response.xml.erb +13 -13
  103. data/tests/spec/stubs/responses/get_command_output_response_not_done.xml.erb +10 -10
  104. data/tests/spec/stubs/responses/get_powershell_keepalive_response.xml.erb +10 -10
  105. data/tests/spec/stubs/responses/get_powershell_output_response.xml.erb +12 -12
  106. data/tests/spec/stubs/responses/get_powershell_output_response_not_done.xml.erb +9 -9
  107. data/tests/spec/stubs/responses/open_shell_v1.xml +19 -19
  108. data/tests/spec/stubs/responses/open_shell_v2.xml +20 -20
  109. data/tests/spec/stubs/responses/soap_fault_v1.xml +36 -36
  110. data/tests/spec/stubs/responses/soap_fault_v2.xml +42 -42
  111. data/tests/spec/stubs/responses/wmi_error_v2.xml +41 -41
  112. data/tests/spec/wsmv/cleanup_command_spec.rb +22 -22
  113. data/tests/spec/wsmv/close_shell_spec.rb +17 -17
  114. data/tests/spec/wsmv/command_output_decoder_spec.rb +37 -37
  115. data/tests/spec/wsmv/command_output_spec.rb +45 -45
  116. data/tests/spec/wsmv/command_spec.rb +19 -19
  117. data/tests/spec/wsmv/configuration_spec.rb +17 -17
  118. data/tests/spec/wsmv/create_pipeline_spec.rb +31 -31
  119. data/tests/spec/wsmv/create_shell_spec.rb +38 -38
  120. data/tests/spec/wsmv/init_runspace_pool_spec.rb +36 -36
  121. data/tests/spec/wsmv/keep_alive_spec.rb +21 -21
  122. data/tests/spec/wsmv/receive_response_reader_spec.rb +123 -123
  123. data/tests/spec/wsmv/send_data_spec.rb +30 -30
  124. data/tests/spec/wsmv/wql_query_spec.rb +13 -13
  125. data/tests/spec/wsmv/write_stdin_spec.rb +22 -22
  126. data/winrm.gemspec +47 -42
  127. metadata +7 -3
@@ -1,130 +1,130 @@
1
- # encoding: UTF-8
2
- #
3
- # Copyright 2015 Matt Wrock <matt@mattwrock.com>
4
- # Copyright 2016 Shawn Neal <sneal@sneal.net>
5
- #
6
- # Licensed under the Apache License, Version 2.0 (the 'License');
7
- # you may not use this file except in compliance with the License.
8
- # You may obtain a copy of the License at
9
- #
10
- # http://www.apache.org/licenses/LICENSE-2.0
11
- #
12
- # Unless required by applicable law or agreed to in writing, software
13
- # distributed under the License is distributed on an 'AS IS' BASIS,
14
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15
- # See the License for the specific language governing permissions and
16
- # limitations under the License.
17
-
18
- require_relative 'uuid'
19
- require_relative 'message_data'
20
-
21
- module WinRM
22
- # PowerShell Remoting Protcol module
23
- module PSRP
24
- # PowerShell Remoting Protocol base message.
25
- # http://download.microsoft.com/download/9/5/E/95EF66AF-9026-4BB0-A41D-A4F81802D92C/%5BMS-PSRP%5D.pdf
26
- class Message
27
- include UUID
28
-
29
- # Value of message destination when sent to a client
30
- CLIENT_DESTINATION = 1
31
-
32
- # Value of message destination when sent to a server
33
- SERVER_DESTINATION = 2
34
-
35
- # All known PSRP message types
36
- MESSAGE_TYPES = {
37
- session_capability: 0x00010002,
38
- init_runspacepool: 0x00010004,
39
- public_key: 0x00010005,
40
- encrypted_session_key: 0x00010006,
41
- public_key_request: 0x00010007,
42
- connect_runspacepool: 0x00010008,
43
- runspace_init_data: 0x0002100b,
44
- reset_runspace_state: 0x0002100c,
45
- set_max_runspaces: 0x00021002,
46
- set_min_runspaces: 0x00021003,
47
- runspace_availability: 0x00021004,
48
- runspacepool_state: 0x00021005,
49
- create_pipeline: 0x00021006,
50
- get_available_runspaces: 0x00021007,
51
- user_event: 0x00021008,
52
- application_private_data: 0x00021009,
53
- get_command_metadata: 0x0002100a,
54
- runspacepool_host_call: 0x00021100,
55
- runspacepool_host_response: 0x00021101,
56
- pipeline_input: 0x00041002,
57
- end_of_pipeline_input: 0x00041003,
58
- pipeline_output: 0x00041004,
59
- error_record: 0x00041005,
60
- pipeline_state: 0x00041006,
61
- debug_record: 0x00041007,
62
- verbose_record: 0x00041008,
63
- warning_record: 0x00041009,
64
- progress_record: 0x00041010,
65
- information_record: 0x00041011,
66
- pipeline_host_call: 0x00041100,
67
- pipeline_host_response: 0x00041101
68
- }.freeze
69
-
70
- # Creates a new PSRP message instance
71
- # @param runspace_pool_id [String] The UUID of the remote shell/runspace pool.
72
- # @param pipeline_id [String] The UUID to correlate the command/pipeline response
73
- # @param type [Fixnum] The PSRP MessageType. This is most commonly
74
- # specified in hex, e.g. 0x00010002.
75
- # @param data [String] The PSRP payload as serialized XML
76
- # @param destination [Fixnum] The destination for this message - client or server
77
- def initialize(
78
- runspace_pool_id,
79
- type,
80
- data,
81
- pipeline_id = nil,
82
- destination = SERVER_DESTINATION
83
- )
84
- raise 'invalid message type' unless MESSAGE_TYPES.values.include?(type)
85
-
86
- @data = data
87
- @destination = destination
88
- @type = type
89
- @pipeline_id = pipeline_id
90
- @runspace_pool_id = runspace_pool_id
91
- end
92
-
93
- attr_reader :destination, :type, :runspace_pool_id, :pipeline_id, :data
94
-
95
- # Returns the raw PSRP message bytes ready for transfer to Windows inside a
96
- # WinRM message.
97
- # @return [Array<Byte>] Unencoded raw byte array of the PSRP message.
98
- def bytes
99
- [
100
- int16le(destination),
101
- int16le(type),
102
- uuid_to_windows_guid_bytes(runspace_pool_id),
103
- uuid_to_windows_guid_bytes(pipeline_id),
104
- byte_order_mark,
105
- data_bytes
106
- ].flatten
107
- end
108
-
109
- # Parses the raw data to a MessageData class
110
- # @return [MessageData::Base] MessageData corresponding to this message type
111
- def parsed_data
112
- @parsed_data ||= MessageData.parse(self)
113
- end
114
-
115
- private
116
-
117
- def byte_order_mark
118
- [239, 187, 191]
119
- end
120
-
121
- def data_bytes
122
- @data_bytes ||= data.force_encoding('utf-8').bytes
123
- end
124
-
125
- def int16le(int16)
126
- [int16].pack('N').unpack('C4').reverse
127
- end
128
- end
129
- end
130
- end
1
+ # encoding: UTF-8
2
+ #
3
+ # Copyright 2015 Matt Wrock <matt@mattwrock.com>
4
+ # Copyright 2016 Shawn Neal <sneal@sneal.net>
5
+ #
6
+ # Licensed under the Apache License, Version 2.0 (the 'License');
7
+ # you may not use this file except in compliance with the License.
8
+ # You may obtain a copy of the License at
9
+ #
10
+ # http://www.apache.org/licenses/LICENSE-2.0
11
+ #
12
+ # Unless required by applicable law or agreed to in writing, software
13
+ # distributed under the License is distributed on an 'AS IS' BASIS,
14
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15
+ # See the License for the specific language governing permissions and
16
+ # limitations under the License.
17
+
18
+ require_relative 'uuid'
19
+ require_relative 'message_data'
20
+
21
+ module WinRM
22
+ # PowerShell Remoting Protcol module
23
+ module PSRP
24
+ # PowerShell Remoting Protocol base message.
25
+ # http://download.microsoft.com/download/9/5/E/95EF66AF-9026-4BB0-A41D-A4F81802D92C/%5BMS-PSRP%5D.pdf
26
+ class Message
27
+ include UUID
28
+
29
+ # Value of message destination when sent to a client
30
+ CLIENT_DESTINATION = 1
31
+
32
+ # Value of message destination when sent to a server
33
+ SERVER_DESTINATION = 2
34
+
35
+ # All known PSRP message types
36
+ MESSAGE_TYPES = {
37
+ session_capability: 0x00010002,
38
+ init_runspacepool: 0x00010004,
39
+ public_key: 0x00010005,
40
+ encrypted_session_key: 0x00010006,
41
+ public_key_request: 0x00010007,
42
+ connect_runspacepool: 0x00010008,
43
+ runspace_init_data: 0x0002100b,
44
+ reset_runspace_state: 0x0002100c,
45
+ set_max_runspaces: 0x00021002,
46
+ set_min_runspaces: 0x00021003,
47
+ runspace_availability: 0x00021004,
48
+ runspacepool_state: 0x00021005,
49
+ create_pipeline: 0x00021006,
50
+ get_available_runspaces: 0x00021007,
51
+ user_event: 0x00021008,
52
+ application_private_data: 0x00021009,
53
+ get_command_metadata: 0x0002100a,
54
+ runspacepool_host_call: 0x00021100,
55
+ runspacepool_host_response: 0x00021101,
56
+ pipeline_input: 0x00041002,
57
+ end_of_pipeline_input: 0x00041003,
58
+ pipeline_output: 0x00041004,
59
+ error_record: 0x00041005,
60
+ pipeline_state: 0x00041006,
61
+ debug_record: 0x00041007,
62
+ verbose_record: 0x00041008,
63
+ warning_record: 0x00041009,
64
+ progress_record: 0x00041010,
65
+ information_record: 0x00041011,
66
+ pipeline_host_call: 0x00041100,
67
+ pipeline_host_response: 0x00041101
68
+ }.freeze
69
+
70
+ # Creates a new PSRP message instance
71
+ # @param runspace_pool_id [String] The UUID of the remote shell/runspace pool.
72
+ # @param pipeline_id [String] The UUID to correlate the command/pipeline response
73
+ # @param type [Fixnum] The PSRP MessageType. This is most commonly
74
+ # specified in hex, e.g. 0x00010002.
75
+ # @param data [String] The PSRP payload as serialized XML
76
+ # @param destination [Fixnum] The destination for this message - client or server
77
+ def initialize(
78
+ runspace_pool_id,
79
+ type,
80
+ data,
81
+ pipeline_id = nil,
82
+ destination = SERVER_DESTINATION
83
+ )
84
+ raise 'invalid message type' unless MESSAGE_TYPES.values.include?(type)
85
+
86
+ @data = data
87
+ @destination = destination
88
+ @type = type
89
+ @pipeline_id = pipeline_id
90
+ @runspace_pool_id = runspace_pool_id
91
+ end
92
+
93
+ attr_reader :destination, :type, :runspace_pool_id, :pipeline_id, :data
94
+
95
+ # Returns the raw PSRP message bytes ready for transfer to Windows inside a
96
+ # WinRM message.
97
+ # @return [Array<Byte>] Unencoded raw byte array of the PSRP message.
98
+ def bytes
99
+ [
100
+ int16le(destination),
101
+ int16le(type),
102
+ uuid_to_windows_guid_bytes(runspace_pool_id),
103
+ uuid_to_windows_guid_bytes(pipeline_id),
104
+ byte_order_mark,
105
+ data_bytes
106
+ ].flatten
107
+ end
108
+
109
+ # Parses the raw data to a MessageData class
110
+ # @return [MessageData::Base] MessageData corresponding to this message type
111
+ def parsed_data
112
+ @parsed_data ||= MessageData.parse(self)
113
+ end
114
+
115
+ private
116
+
117
+ def byte_order_mark
118
+ [239, 187, 191]
119
+ end
120
+
121
+ def data_bytes
122
+ @data_bytes ||= data.force_encoding('utf-8').bytes
123
+ end
124
+
125
+ def int16le(int16)
126
+ [int16].pack('N').unpack('C4').reverse
127
+ end
128
+ end
129
+ end
130
+ end
@@ -1,42 +1,42 @@
1
- # encoding: UTF-8
2
- #
3
- # Copyright 2016 Matt Wrock <matt@mattwrock.com>
4
- #
5
- # Licensed under the Apache License, Version 2.0 (the 'License');
6
- # you may not use this file except in compliance with the License.
7
- # You may obtain a copy of the License at
8
- #
9
- # http://www.apache.org/licenses/LICENSE-2.0
10
- #
11
- # Unless required by applicable law or agreed to in writing, software
12
- # distributed under the License is distributed on an 'AS IS' BASIS,
13
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
- # See the License for the specific language governing permissions and
15
- # limitations under the License.
16
-
17
- require_relative 'message_data/base'
18
- require_relative 'message_data/error_record'
19
- require_relative 'message_data/pipeline_output'
20
- require_relative 'message_data/pipeline_host_call'
21
- require_relative 'message_data/pipeline_state'
22
- require_relative 'message_data/runspacepool_host_call'
23
- require_relative 'message_data/runspacepool_state'
24
- require_relative 'message_data/session_capability'
25
-
26
- module WinRM
27
- # PowerShell Remoting Protcol module
28
- module PSRP
29
- # PowerShell Remoting Protocol message data.
30
- module MessageData
31
- def self.parse(message)
32
- type_key = WinRM::PSRP::Message::MESSAGE_TYPES.key(message.type)
33
- type = camelize(type_key.to_s).to_sym
34
- const_get(type).new(message.data) if MessageData.constants.include?(type)
35
- end
36
-
37
- def self.camelize(underscore)
38
- underscore.split('_').collect(&:capitalize).join
39
- end
40
- end
41
- end
42
- end
1
+ # encoding: UTF-8
2
+ #
3
+ # Copyright 2016 Matt Wrock <matt@mattwrock.com>
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the 'License');
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # http://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an 'AS IS' BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ require_relative 'message_data/base'
18
+ require_relative 'message_data/error_record'
19
+ require_relative 'message_data/pipeline_output'
20
+ require_relative 'message_data/pipeline_host_call'
21
+ require_relative 'message_data/pipeline_state'
22
+ require_relative 'message_data/runspacepool_host_call'
23
+ require_relative 'message_data/runspacepool_state'
24
+ require_relative 'message_data/session_capability'
25
+
26
+ module WinRM
27
+ # PowerShell Remoting Protcol module
28
+ module PSRP
29
+ # PowerShell Remoting Protocol message data.
30
+ module MessageData
31
+ def self.parse(message)
32
+ type_key = WinRM::PSRP::Message::MESSAGE_TYPES.key(message.type)
33
+ type = camelize(type_key.to_s).to_sym
34
+ const_get(type).new(message.data) if MessageData.constants.include?(type)
35
+ end
36
+
37
+ def self.camelize(underscore)
38
+ underscore.split('_').collect(&:capitalize).join
39
+ end
40
+ end
41
+ end
42
+ end
@@ -1,49 +1,49 @@
1
- # encoding: UTF-8
2
- #
3
- # Copyright 2016 Matt Wrock <matt@mattwrock.com>
4
- #
5
- # Licensed under the Apache License, Version 2.0 (the 'License');
6
- # you may not use this file except in compliance with the License.
7
- # You may obtain a copy of the License at
8
- #
9
- # http://www.apache.org/licenses/LICENSE-2.0
10
- #
11
- # Unless required by applicable law or agreed to in writing, software
12
- # distributed under the License is distributed on an 'AS IS' BASIS,
13
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
- # See the License for the specific language governing permissions and
15
- # limitations under the License.
16
-
17
- require 'nori'
18
-
19
- module WinRM
20
- # PowerShell Remoting Protcol module
21
- module PSRP
22
- # PowerShell Remoting Protocol message data.
23
- module MessageData
24
- # base class for message data
25
- class Base
26
- def initialize(data)
27
- @raw = data
28
- end
29
-
30
- # @return [String] raw message data
31
- attr_reader :raw
32
-
33
- protected
34
-
35
- def clixml
36
- @clixml ||= begin
37
- parser = Nori.new(
38
- parser: :rexml,
39
- advanced_typecasting: false,
40
- convert_tags_to: ->(tag) { tag.snakecase.to_sym },
41
- strip_namespaces: true
42
- )
43
- parser.parse(raw)[:obj][:ms]
44
- end
45
- end
46
- end
47
- end
48
- end
49
- end
1
+ # encoding: UTF-8
2
+ #
3
+ # Copyright 2016 Matt Wrock <matt@mattwrock.com>
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the 'License');
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # http://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an 'AS IS' BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ require 'nori'
18
+
19
+ module WinRM
20
+ # PowerShell Remoting Protcol module
21
+ module PSRP
22
+ # PowerShell Remoting Protocol message data.
23
+ module MessageData
24
+ # base class for message data
25
+ class Base
26
+ def initialize(data)
27
+ @raw = data
28
+ end
29
+
30
+ # @return [String] raw message data
31
+ attr_reader :raw
32
+
33
+ protected
34
+
35
+ def clixml
36
+ @clixml ||= begin
37
+ parser = Nori.new(
38
+ parser: :rexml,
39
+ advanced_typecasting: false,
40
+ convert_tags_to: ->(tag) { tag.snakecase.to_sym },
41
+ strip_namespaces: true
42
+ )
43
+ parser.parse(raw)[:obj][:ms]
44
+ end
45
+ end
46
+ end
47
+ end
48
+ end
49
+ end
@@ -1,68 +1,68 @@
1
- # -*- encoding: utf-8 -*-
2
- #
3
- # Copyright 2016 Matt Wrock <matt@mattwrock.com>
4
- #
5
- # Licensed under the Apache License, Version 2.0 (the "License");
6
- # you may not use this file except in compliance with the License.
7
- # You may obtain a copy of the License at
8
- #
9
- # http://www.apache.org/licenses/LICENSE-2.0
10
- #
11
- # Unless required by applicable law or agreed to in writing, software
12
- # distributed under the License is distributed on an "AS IS" BASIS,
13
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
- # See the License for the specific language governing permissions and
15
- # limitations under the License.
16
-
17
- module WinRM
18
- module PSRP
19
- module MessageData
20
- # error record message type
21
- class ErrorRecord < Base
22
- def exception
23
- @exception ||= property_hash('Exception')
24
- end
25
-
26
- def fully_qualified_error_id
27
- @fully_qualified_error_id ||= string_prop('FullyQualifiedErrorId')
28
- end
29
-
30
- def invocation_info
31
- @invocation_info ||= property_hash('InvocationInfo')
32
- end
33
-
34
- def error_category_message
35
- @error_category_message ||= string_prop('ErrorCategory_Message')
36
- end
37
-
38
- def error_details_script_stack_trace
39
- @error_details_script_stack_trace ||= string_prop('ErrorDetails_ScriptStackTrace')
40
- end
41
-
42
- def doc
43
- @doc ||= REXML::Document.new(raw)
44
- end
45
-
46
- def string_prop(prop_name)
47
- prop = REXML::XPath.first(doc, "//*[@N='#{prop_name}']")
48
- prop.text if prop
49
- end
50
-
51
- def property_hash(prop_name)
52
- prop_nodes = REXML::XPath.first(doc, "//*[@N='#{prop_name}']/Props")
53
- prop_nodes.elements.each_with_object({}) do |node, props|
54
- name = node.attributes['N']
55
- props[underscore(name).to_sym] = node.text if node.text
56
- end
57
- end
58
-
59
- def underscore(camel)
60
- camel.gsub(/::/, '/')
61
- .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
62
- .gsub(/([a-z\d])([A-Z])/, '\1_\2')
63
- .tr('-', '_').downcase
64
- end
65
- end
66
- end
67
- end
68
- end
1
+ # -*- encoding: utf-8 -*-
2
+ #
3
+ # Copyright 2016 Matt Wrock <matt@mattwrock.com>
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # http://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ module WinRM
18
+ module PSRP
19
+ module MessageData
20
+ # error record message type
21
+ class ErrorRecord < Base
22
+ def exception
23
+ @exception ||= property_hash('Exception')
24
+ end
25
+
26
+ def fully_qualified_error_id
27
+ @fully_qualified_error_id ||= string_prop('FullyQualifiedErrorId')
28
+ end
29
+
30
+ def invocation_info
31
+ @invocation_info ||= property_hash('InvocationInfo')
32
+ end
33
+
34
+ def error_category_message
35
+ @error_category_message ||= string_prop('ErrorCategory_Message')
36
+ end
37
+
38
+ def error_details_script_stack_trace
39
+ @error_details_script_stack_trace ||= string_prop('ErrorDetails_ScriptStackTrace')
40
+ end
41
+
42
+ def doc
43
+ @doc ||= REXML::Document.new(raw)
44
+ end
45
+
46
+ def string_prop(prop_name)
47
+ prop = REXML::XPath.first(doc, "//*[@N='#{prop_name}']")
48
+ prop.text if prop
49
+ end
50
+
51
+ def property_hash(prop_name)
52
+ prop_nodes = REXML::XPath.first(doc, "//*[@N='#{prop_name}']/Props")
53
+ prop_nodes.elements.each_with_object({}) do |node, props|
54
+ name = node.attributes['N']
55
+ props[underscore(name).to_sym] = node.text if node.text
56
+ end
57
+ end
58
+
59
+ def underscore(camel)
60
+ camel.gsub(/::/, '/')
61
+ .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
62
+ .gsub(/([a-z\d])([A-Z])/, '\1_\2')
63
+ .tr('-', '_').downcase
64
+ end
65
+ end
66
+ end
67
+ end
68
+ end