PageRenderTime 45ms CodeModel.GetById 13ms RepoModel.GetById 0ms app.codeStats 0ms

/IronPython_Main/Languages/IronPython/Samples/IPPowerShell/readme.htm

#
HTML | 216 lines | 208 code | 8 blank | 0 comment | 0 complexity | 3a8045628ac071c6974dbe8552afd032 MD5 | raw file
Possible License(s): GPL-2.0, MPL-2.0-no-copyleft-exception, CPL-1.0, CC-BY-SA-3.0, BSD-3-Clause, ISC, AGPL-3.0, LGPL-2.1, Apache-2.0 
    

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html>

    2. 

  2. 

    3. 

  3. <head>

    4. 

  4. <link rel="stylesheet" type="text/css" href="../Samples.css">

    5. 

  5. <meta http-equiv="Content-Type" content="text/html; charset=windows-1252">

    6. 

  6. <title>PowerShell from IronPython</title>

    7. 

  7. <style type="text/css">

    8. 

  8.   .style5 {

    9. 

  9. 	margin-left: 40px;

    10. 

  10. }

    11. 

  11.   .style3 {

    12. 

  12. 	font-weight: normal;

    13. 

  13. }

    14. 

  14. </style>

    15. 

  15. </head>

    16. 

  16. 

    17. 

  17. <body class="body">

    18. 

  18. 

    19. 

  19. <hr>

    20. 

  20. <p class="CopyrightText">Information in this document is subject to change without notice. The example companies, organizations, 

    21. 

  21. products, people, and events depicted herein are fictitious. No association with any real company, organization, product, 

    22. 

  22. person or event is intended or should be inferred. Complying with all applicable copyright laws is the responsibility of 

    23. 

  23. the user. Without limiting the rights under copyright, no part of this document may be reproduced, stored in or introduced 

    24. 

  24. into a retrieval system, or transmitted in any form or by any means (electronic, mechanical, photocopying, recording, or 

    25. 

  25. otherwise), or for any purpose, without the express written permission of Microsoft Corporation.</p>

    26. 

  26. <p class="CopyrightText">&nbsp;</p>

    27. 

  27. <p class="CopyrightText">Microsoft may have patents, patent applications, trademarked, copyrights, or other intellectual 

    28. 

  28. property rights covering subject matter in this document. Except as expressly provided in any written license agreement 

    29. 

  29. from Microsoft, the furnishing of this document does not give you any license to these patents, trademarks, copyrights, 

    30. 

  30. or other intellectual property.</p>

    31. 

  31. <p class="CopyrightText">&nbsp;</p>

    32. 

  32. <div class="Section1">

    33. 

  33. 	<p class="CopyrightText">Š Microsoft Corporation. All rights reserved.</p>

    34. 

  34. 	<p class="CopyrightText">&nbsp;</p>

    35. 

  35. 	<p class="CopyrightText">Microsoft, MS-DOS, MS, Windows, Windows NT, MSDN, Active Directory, BizTalk, SQL Server, SharePoint, 

    36. 

  36. 	Outlook, PowerPoint, FrontPage, Visual Basic, Visual C++, Visual J++, Visual InterDev, Visual SourceSafe, Visual C#, 

    37. 

  37. 	Visual J#,&nbsp; and Visual Studio are either registered trademarks or trademarks of Microsoft Corporation in the 

    38. 

  38. 	U.S.A. and/or other countries.</p>

    39. 

  39. 	<p class="CopyrightText">&nbsp;</p>

    40. 

  40. 	<p class="CopyrightText">Other product and company names herein may be the trademarks of their respective owners.</p>

    41. 

  41. </div>

    42. 

  42. <hr>

    43. 

  43. <p class="body">&nbsp;</p>

    44. 

  44. <p class="CopyrightText">This source code is subject to terms and conditions of the Apache License, Version 2.0. A 

    45. 

  45.     copy of the license can be found in the License.html file at the root of this distribution. If 

    46. 

  46.     you cannot locate the  Apache License, Version 2.0, please send an email to

    47. 

  47.     ironpy@microsoft.com. By using this source code in any fashion, you are agreeing to be bound 

    48. 

  48.     by the terms of the Apache License, Version 2.0.</p>

    49. 

  49. <p class="CopyrightText">&nbsp;</p>

    50. 

  50. <p class="body">&nbsp;</p>

    51. 

  51. <p class="title2">PowerShell from IronPython</p>

    52. 

  52. <p class="body">A brief example which utilizes managed Windows PowerShell APIs to run shell commands directly from IronPython.</p>

    53. 

  53. <p class="body">&nbsp;</p>

    54. 

  54. <p></p>

    55. 

  55. <p class="contentsheading">Overview</p>

    56. 

  56. <p class="Body">PowerShell (PS) is a new command-line shell for Windows which provides some pretty dramatic improvements over 

    57. 

  57. its predecessor - the DOS prompt. The most important new feature PS provides as far as IronPython is concerned 

    58. 

  58. is a set of managed interfaces accessible via the Common Language Runtime. We 

    59. 

  59. can tap directly into these from IronPython.</p><p class="Body">Utilizing PS from IronPython offers quite a bit 

    60. 

  60. more to developers than the standard Python modules used to run commands, manipulate the filesystem, etc. This sample 

    61. 

  61. includes two Python scripts, each of which are designed to determine if your host meets some of the minimum system requirements to 

    62. 

  62. play the game &quot;Age of Empires III Trial Edition&quot;. What sets these two scripts apart is that the first script, minsysreq_ps.py, leverages a helper module, powershell.py, to obtain 

    63. 

  63. PS functionality in a very useful and 

    64. 

  64. object-oriented way. The second script, minsysreq.py, uses PS commands directly to 

    65. 

  65. achieve the same results.</p><p class="Body">Note: the scripts distributed with this sample collect various performance 

    66. 

  66. and runtime info about your PC and emit this to the console for your own personal use.&nbsp; None of this information is 

    67. 

  67. transmitted to Microsoft.</p>

    68. 

  68. <p class="contentsheading">Prerequisites</p>

    69. 

  69. <p class="body">The prerequisites to successfully run the PowerShell from IronPython demo are:</p>

    70. 

  70. <ul>

    71. 

  71. 	<li class="normal">IronPython 2.6 distribution

    72. 

  72. 	<ul>

    73. 

  73. 		<li>If you are new to IronPython, please go over the tutorial

    74. 

  74. that comes with this distribution</li>

    75. 

  75. 		<li>Download from 

    76. 

  76. 		<a href="http://ironpython.codeplex.com/Release/ProjectReleases.aspx?ReleaseId=12482">here</a></li>

    77. 

  77. 	</ul>

    78. 

  78. 	</li>

    79. 

  79. 	<li>

    80. 

  80. 	<font face="Verdana" style="font-size: 11pt">Windows PowerShell 2.0</font><ul>

    81. 

  81. 		<li>

    82. 

  82. 		<font face="Verdana" style="font-size: 11pt">Needed to access the managed PS APIs</font></li>

    83. 

  83. 		<li>

    84. 

  84. 		<font face="Verdana" style="font-size: 11pt">Download from

    85. 

  85. 		<a href="http://technet.microsoft.com/en-us/scriptcenter/default.aspx">here</a></font></li>

    86. 

  86. 	</ul>

    87. 

  87. 	</li>

    88. 

  88. 	<li>

    89. 

  89. 	<font face="Verdana" style="font-size: 11pt">Age of Empires III Trial Edition (<b>Optional</b>)</font><ul>

    90. 

  90. 		<li><font face="Verdana" style="font-size: 11pt">Run this while executing the minsysreq* scripts distributed with this sample to get runtime info about Age 

    91. 

  91. 		of Empires III</font></li><li><font face="Verdana" style="font-size: 11pt">This step is entirely optional. The 

    92. 

  92. 		sample scripts will still run without installing Age of Empires III!</font></li><li>

    93. 

  93. 		<font face="Verdana" style="font-size: 11pt">Download from

    94. 

  94. 		<a href="http://www.microsoft.com/downloads/details.aspx?FamilyID=f627e37b-a8e8-4537-9a88-3c19b670c92a&DisplayLang=en">

    95. 

  95. 		here</a></font></li>

    96. 

  96. 	</ul>

    97. 

  97. 	</li>

    98. 

  98. </ul>

    99. 

  99. <p class="contentsheading">Getting Started<br>

    100. 

  100. </p>

    101. 

  101. <p class="body">Please make sure the sample folder <i>IPPowerShell </i>(where this readme.htm is located)<i> </i>

    102. 

  102. contains at least the following:</p>

    103. 

  103. <blockquote>

    104. 

  104. 	<blockquote>

    105. 

  105. 		<p class="body">.\minsysreq.py</p><p class="body">.\minsysreq_ps.py</p><p class="body">.\powershell.py<br>

    106. 

  106. 		</p>

    107. 

  107. 	</blockquote>

    108. 

  108. </blockquote>

    109. 

  109. <p class="body">HINT: if the folder containing the IronPython distribution

    110. 

  110. is not already in your PATH environment variable, please add it from the command 

    111. 

  111. prompt you'll be working in.&nbsp; By doing this you will be able to run the &quot;ipy&quot; 

    112. 

  112. command from any arbitrary directory: </p>

    113. 

  113. <p class="style5"><strong>s</strong><span class="style3">e<span class="typedexample"><strong>t 

    114. 

  114. PATH=%PATH%;%ProgramFiles%\IronPython 2.6</strong></span></span></p>

    115. 

  115. <p class="contentsheading">Using powershell.py from an Interactive IronPython Session</p>

    116. 

  116. <p class="body">From the command prompt, navigate to the <i>IPPowerShell</i> directory and type the following command: </p>

    117. 

  117. <p class="typedexample">&gt; ipy.exe -i powershell.py</p><p class="typedexample">&nbsp;</p>

    118. 

  118. <p class="body">This starts an interactive IronPython session and imports quite a few modules, 

    119. 

  119. functions, objects, etc. into the global namespace. Most importantly you should find a &quot;shell&quot; object. &quot;shell&quot; 

    120. 

  120. is an instance of the Shell class (defined within powershell.py) which in turn is a wrapper for the standard PS 

    121. 

  121. cmdlets and aliases. You should take special note that the conversion from PS to IronPython involved the 

    122. 

  122. following rules with respect to Shell's methods:</p><ul>

    123. 

  123. 	<li>

    124. 

  124. 	<p class="body">for every PS cmdlet, there is a corresponding Shell method where the name is completely 

    125. 

  125. 	lowercase with &quot;-&quot;s translated into &quot;_&quot;s.&nbsp; E.g., the PS command &quot;<b>Get-Process</b>&quot; becomes the Shell method 

    126. 

  126. 	&quot;<b>shell.get_process()</b>&quot;</p></li>

    127. 

  127. 	<li>

    128. 

  128. 	<p class="body">for most simple PS aliases, there is a corresponding Shell method where the name is 

    129. 

  129. 	completely lowercase with &quot;-&quot;s translated into &quot;_&quot;s.&nbsp; E.g., the PS alias &quot;<b>ls</b>&quot; becomes the Shell 

    130. 

  130. 	method &quot;<b>shell.ls()</b>&quot;. Aliases that do not directly map into a corresponding 

    131. 

  131. 	PS cmdlet (such as &quot;more&quot;) have no Shell method mapping.</p></li>

    132. 

  132. 	<li>

    133. 

  133. 	<p class="body">if a PS cmdlet accepts (non-parameter) arguments, they are supplied directly to the Shell 

    134. 

  134. 	method in the form of a single string parameter. E.g., the PS command &quot;<b>Write-Error &quot;Some error message 

    135. 

  135. 	here...&quot;</b>&quot; would become &quot;<b>shell.write_error(&quot;Some error message here...&quot;)</b>&quot;</p></li>

    136. 

  136. 	<li>

    137. 

  137. 	<p class="body">cmdlet parameters are mapped as keyword parameters of Shell methods.&nbsp; E.g., the PS 

    138. 

  138. 	command &quot;<b>Get-Date -DisplayHint date</b>&quot; becomes the Shell method &quot;<b>shell.get_date(DisplayHint='date')</b>&quot; </p></li>

    139. 

  139. 	<li>

    140. 

  140. 	<p class="body">the return value from one cmdlet can be piped in as the input to another cmdlet. To do this, one just needs to invoke the 2nd cmdlet method on the return value of the first cmdlet.&nbsp; E.g., the 

    141. 

  141. 	PS command &quot;<b>Get-Process ipy | ConvertTo-Html</b>&quot; becomes &quot;<b>shell.get_process(&quot;ipy&quot;).convertto_html()</b>&quot;</p></li>

    142. 

  142. 	<li>

    143. 

  143. 	<p class="body">properties of the return value object from a PS cmdlet are accessible as Python object attributes.&nbsp; 

    144. 

  144. 	E.g., the PS command &quot;<b>Get-Process ipy | Select-Object -First 1 -Property WS</b>&quot; becomes &quot;<b>shell.get_process(&quot;ipy&quot;)[0].WS</b>&quot;&nbsp;

    145. 

  145. 	</p></li>

    146. 

  146. </ul>

    147. 

  147. <p class="body">&nbsp;</p>

    148. 

  148. <table border="0" width="100%" height="36" bgcolor="#E6E6E6" cellpadding="15" cellspacing="1">

    149. 

  149. 	<tr>

    150. 

  150. 		<td height="36" width="523">

    151. 

  151. 		&gt;&gt;&gt; from powershell import *<br>

    152. 

  152. 		&gt;&gt;&gt; shell.dir()<br>

    153. 

  153. 		Directory: Microsoft.PowerShell.Core\FileSystem::E:\Ip\IronPython\Samples\IPPowerShell<br>

    154. 

  154. 		<br>

    155. 

  155. 		<br>

    156. 

  156. 		Mode LastWriteTime Length Name<br>

    157. 

  157. 		---- ------------- ------ ----<br>

    158. 

  158. 		-a--- 9/7/2006 3:38 PM 3602 minsysreq.py<br>

    159. 

  159. 		-a--- 9/11/2006 12:54 PM 3206 minsysreq_ps.py<br>

    160. 

  160. 		-a--- 9/11/2006 12:21 PM 6261 powershell.py<br>

    161. 

  161. 		-a--- 9/11/2006 1:06 PM 11567 readme.htm<br>

    162. 

  162. 		&gt;&gt;&gt;<br>

    163. 

  163. 		&gt;&gt;&gt;<br>

    164. 

  164. 		&gt;&gt;&gt; shell.dir().sort(&quot;LastWriteTime&quot;, Descending=True).select_object(&quot;Name&quot;)<br>

    165. 

  165. 		Name<br>

    166. 

  166. 		----<br>

    167. 

  167. 		readme.htm<br>

    168. 

  168. 		minsysreq_ps.py<br>

    169. 

  169. 		powershell.py<br>

    170. 

  170. 		minsysreq.py<br>

    171. 

  171. 		&gt;&gt;&gt;</td>

    172. 

  172. 	</tr>

    173. 

  173. </table>

    174. 

  174. 

    175. 

  175. <p class="contentsheading">Checking Minimum System Requirements for AOE III Trial 

    176. 

  176. Edition</p>

    177. 

  177. <p class="body">Included with this sample are two scripts designed to automatically determine if your system is capable 

    178. 

  178. of playing Age of Empires III Trial Edition by using PS API(s) from IronPython. The first script, 

    179. 

  179. minsysreq_ps.py, uses the nice PS wrapper module powershell.py, while minsysreq.py uses the managed PS assembly directly 

    180. 

  180. to achieve the same goal. Furthermore, both scripts will emit some runtime information such as memory usage if AOE III 

    181. 

  181. is currently running. This serves as a nice example because the standard Python modules provide little support for 

    182. 

  182. obtaining this type of information.</p><p class="body">To run these scripts it is necessary to issue the following 

    183. 

  183. commands from the <i>IPPowerShell</i> directory: &quot;<b>ipy.exe minisysreq_ps.py</b>&quot; and &quot;<b>ipy.exe minsysreq.py</b>&quot;. The output for both of 

    184. 

  184. these scripts should be identical and similar to the following:</p><p class="body">&nbsp;</p>

    185. 

  185. <table border="0" width="100%" height="36" bgcolor="#E6E6E6" cellpadding="15" cellspacing="1">

    186. 

  186. 	<tr>

    187. 

  187. 		<td height="36" width="523">

    188. 

  188. 		E:\Ip\IronPython\Samples\IPPowerShell&gt;ipy minsysreq.py<br>

    189. 

  189. 		This program will determine if your PC meets some of the<br>

    190. 

  190. 		minimum system requires to play the game, Age of Empires III Trial.<br>

    191. 

  191. 		<br>

    192. 

  192. 		Your CPU is fast enough (2.211Ghz)!<br>

    193. 

  193. 		<br>

    194. 

  194. 		256 MB is enough video memory!<br>

    195. 

  195. 		<br>

    196. 

  196. 		Have a nice day!</td>

    197. 

  197. 	</tr>

    198. 

  198. </table>

    199. 

  199. 

    200. 

  200. <p class="body">&nbsp;</p><p class="body">If you are 

    201. 

  201. already running AOE III, you'd also see the following extra output:</p>

    202. 

  202. <table border="0" width="100%" height="36" bgcolor="#E6E6E6" cellpadding="15" cellspacing="1">

    203. 

  203. 	<tr>

    204. 

  204. 		<td height="36" width="523">

    205. 

  205. 		It appears as if you're currently running Age of Empires III Trial !<br>

    206. 

  206. 		The game is using 77 megs of RAM and has a process ID of 3956.</td>

    207. 

  207. 	</tr>

    208. 

  208. </table>

    209. 

  209. 

    210. 

  210. <p class="body">&nbsp;</p><p class="body"><font size="4">Please explore the contents of both scripts in the <i>IPPowerShell</i> 

    211. 

  211. directory to assist you in using PowerShell from your own IronPython scripts and modules! </font></p><p class="body">&nbsp;</p>

    212. 

  212. <p class="body">This concludes our tutorial. Have fun playing with PowerShell from IronPython!</p>

    213. 

  213. 

    214. 

  214. </body>

    215. 

  215. 

    216. 

  216. </html>

    217. 

  217.