PowerShell Proxy Extensions (Beta)

Source code checked in, #18667

Project Collection Service Accounts — Mon, 01 Oct 2012 20:52:47 GMT

Upgrade: New Version of LabDefaultTemplate.xaml. To upgrade your build definitions, please visit the following link: http://go.microsoft.com/fwlink/?LinkId=254563

Source code checked in, #18666

Project Collection Service Accounts — Mon, 01 Oct 2012 20:51:24 GMT

Checked in by server upgrade

Source code checked in, #19041

poshoholic — Sat, 11 Aug 2012 16:18:05 GMT

- removed en-us folder since it is no longer necessary

Source code checked in, #19040

poshoholic — Sat, 11 Aug 2012 16:17:43 GMT

- fixed bug preventing the creation of proxy functions for cmdlets that already have defined output types - changed usage of Out-Null such that it isn't pipelined (performance improvement) - replaced all usage of `t in proxy function generation (both for the function script block and the help file) with ${tab}, allowing proxy functions to respect tab configuration in modern editors more easily - added logic to define the proxy function header and include that in the functions that are generated, or in the proxy function metadata object that is returned - fixed internationalization support so that help is properly returned at least in the language in which the module was written - pushed all proxy function region definition text into the string table so that proxy functions can be generated that are 100% localized - added brackets to Where-Object clause in AutoPing.ps1 demo script for clarity - removed psd1 internationalization file since it is not needed by default

Source code checked in, #18861

poshoholic — Tue, 07 Aug 2012 15:51:51 GMT

- moved XML helpers into NewXMLDocument.Library.ps1 - removed unnecessary Set-StrictMode call from New-ProxyFunction.ps1 (this is configured for the whole module; no need to set it in the ps1 file) - added logic to determine whether to use tabs or spaces as well as what the current tab size is set to, with support for PowerShell ISE, PowerGUI and PowerSE (although PowerShell ISE doesn't allow for customization of these settings yet) - replaced use of `t with ${tab} so that the actual tab configuration is used from the start when creating new proxy functions - fixed generation of output type information when creating new proxy functions - fixed generation of cmdlet binding attribute values when creating new proxy functions - fixed placement of xml tag in xml definition when creating new proxy functions - moved warning message text to string table - moved module exports to psm1 file - fixed file encoding for all files (they now use UTF8 encoding) - added special case to Test-InteractiveInvocation that allows for any scripts in the demos subfolder to be considered interactive

Source code checked in, #18620

poshoholic — Mon, 30 Jul 2012 20:56:28 GMT

- moved localizable strings into StringTable.psd1 and pspx.psd1 and updated commands so that they use those strings - fixed default value assignment in New-ProxyFunction - fixed CondtionalPostProcess typo in New-ProxyFunction that prevented some proxies from generating correctly - fixed processing logic in New-ProxyFunction so that it properly prevents passthru from happening unless it is specifically requested - incremented the version number and updated the file listing in the manifest - fixed bug preventing the export of Get-ProxyFunction and the gpx alias - tested and fixed all samples in the demos folder and added comments describing what the scripts do to the top of each file - removed deprecated files from the project

Source code checked in, #18481

poshoholic — Wed, 25 Jul 2012 19:57:32 GMT

- fixed bug in sorting (sorting hash tables isn't the same thing as sorting objects, so extra steps need to be taken)

Updated Release: PSPX (Jul 18, 2012)

poshoholic — Wed, 18 Jul 2012 20:54:56 GMT

First Beta release.

Released: PSPX (Jul 18, 2012)

Wed, 18 Jul 2012 20:54:56 GMT

First Beta release.

Updated Wiki: Home

poshoholic — Wed, 18 Jul 2012 20:38:40 GMT

About the PowerShell Proxy Extensions Module

A powerful module that leverages proxy functions and makes it easier than ever to create these powerful extensions to PowerShell. The module allows you to create everything from very simple proxy functions that extend PowerShell to more complex proxy functions that override and extend existing cmdlets.

The module can be installed automatically by downloading the MSI package or manually by downloading a ZIP file.

The MSI package will install the module under your Documents folder in the following location:

%USERPROFILE%\Documents\WindowsPowerShell\Modules\pspx.

The ZIP file contents need to be manually extracted to one of the paths that is included as part of the PSModulePath environment variable. Typically users will unzip the contents of the ZIP file into the following folder:

%USERPROFILE%\Documents\WindowsPowerShell\Modules *

If the directory doesn't exist then you need to manually create it.

PowerShell Compatibility

Windows PowerShell 2.0
Windows PowerShell 3.0 (currently verified as working on the release preview)

How to use the module

Check if the module is installed correctly, from your PowerShell session type:

PS > Get-Module -Name pspx -ListAvailable

ModuleType Name                      ExportedCommands
---------- ----                      ----------------
Manifest   pspx                      {}

If you don't see the above result then the module was not installed correctly.

Importing the module

PS > Import-Module pspx

# Get a list of module exported commands.
PS > Get-Command -Module pspx | Format-Table CommandType,Name

CommandType     Name
-----------     ----
Alias           Fix-It
Function        Get-ProxyFunction
Function        New-ProxyFunction
Alias           npx
Alias           proxy

Creating proxy functions

Many people believe the best way to learn is by example, and I'm no exception. To see what you can do with this module, take a look at the files in the demos folder under the module installation folder. These files contain commands that can be used to generate proxy functions quickly and easily without having to worry about setting up the functions themselves.

Updated Wiki: Home

poshoholic — Wed, 18 Jul 2012 20:37:32 GMT

About the PowerShell Proxy Extensions Module

If the directory doesn't exist then you need to manually create it.

Prerequisites

Windows PowerShell 2.0 or later

How to use the module

Check if the module is installed correctly, from your PowerShell session type:

PS > Get-Module -Name pspx -ListAvailable

ModuleType Name                      ExportedCommands
---------- ----                      ----------------
Manifest   pspx                      {}

If you don't see the above result then the module was not installed correctly.

Importing the module

PS > Import-Module pspx

# Get a list of module exported commands.
PS > Get-Command -Module pspx | Format-Table CommandType,Name

CommandType     Name
-----------     ----
Alias           Fix-It
Function        Get-ProxyFunction
Function        New-ProxyFunction
Alias           npx
Alias           proxy

Creating proxy functions

Updated Wiki: Home

poshoholic — Wed, 18 Jul 2012 20:12:11 GMT

About the PowerShell Proxy Extensions Module

If the directory doesn't exist then you need to manually create it.

Prerequisites

Windows PowerShell 2.0 http://support.microsoft.com/kb/968929

How to use the module

Check if the module is installed correctly, from your PowerShell session type:

PS > Get-Module -Name pspx -ListAvailable

ModuleType Name                      ExportedCommands
---------- ----                      ----------------
Manifest   pspx                      {}

If you don't see the above result then the module was not installed correctly.

Importing the module

PS > Import-Module pspx

# Get a list of module exported commands.
PS > Get-Command -Module pspx | Format-Table CommandType,Name

CommandType     Name
-----------     ----
Alias           Fix-It
Function        Get-ProxyFunction
Function        New-ProxyFunction
Alias           npx
Alias           proxy

Creating proxy functions

Updated Wiki: Home

poshoholic — Wed, 18 Jul 2012 20:11:44 GMT

About the PowerShell Proxy Extensions Module

If the directory doesn't exist then you need to manually create it.

Prerequisites

Windows PowerShell 2.0 http://support.microsoft.com/kb/968929

How to use the module

Check if the module is installed correctly, from your PowerShell session type:

PS > Get-Module -Name pspx -ListAvailable

ModuleType Name                      ExportedCommands
---------- ----                      ----------------
Manifest   pspx                      {}

If you don't see the above result then the module was not installed correctly.

Importing the module

PS > Import-Module pspx

# Get a list of module exported commands.
PS > Get-Command -Module pspx | Format-Table CommandType,Name

CommandType     Name
-----------     ----
Alias           Fix-It
Function        Get-ProxyFunction
Function        New-ProxyFunction
Alias           npx
Alias           proxy

Using the module

Updated Wiki: Home

poshoholic — Wed, 18 Jul 2012 20:11:32 GMT

About the PowerShell Proxy Extensions Module

If the directory doesn't exist then you need to manually create it.

Prerequisites

Windows PowerShell 2.0 http://support.microsoft.com/kb/968929

How to use the module

Check if the module is installed correctly, from your PowerShell session type:

PS > Get-Module -Name pspx -ListAvailable

ModuleType Name                      ExportedCommands
---------- ----                      ----------------
Manifest   pspx                      {}

If you don't see the above result then the module was not installed correctly.

Importing the module

PS > Import-Module pspx

# Get a list of module exported commands.
PS > Get-Command -Module pspx | Format-Table CommandType,Name

CommandType     Name
-----------     ----
Alias           Fix-It
Function        Get-ProxyFunction
Function        New-ProxyFunction
Alias           npx
Alias           proxy

Using the module

Updated Release: PSPX (Jul 18, 2012)

poshoholic — Wed, 18 Jul 2012 20:07:02 GMT

First Beta release.

Updated Release: PSPX (Jul 18, 2012)

poshoholic — Wed, 18 Jul 2012 20:04:03 GMT

First Beta release.

Updated Wiki: Home

poshoholic — Wed, 18 Jul 2012 20:02:05 GMT

About the PowerShell Proxy Extensions Module

If the directory doesn't exist then you need to manually create it.

Prerequisites

Windows PowerShell 2.0 http://support.microsoft.com/kb/968929

How to use the module

Check if the module is installed correctly, from your PowerShell session type:

PS > Get-Module -Name pspx -ListAvailable

ModuleType Name                      ExportedCommands
---------- ----                      ----------------
Manifest   pspx                      {}

If you don't see the above result then the module was not installed correctly.

Importing the module

PS > Import-Module pspx

# Get a list of module exported commands.
PS > Get-Command -Module pspx | Format-Table CommandType,Name

CommandType     Name
-----------     ----
Alias           Fix-It
Function        Get-ProxyFunction
Function        New-ProxyFunction
Alias           npx
Alias           proxy

Source code checked in, #18028

poshoholic — Mon, 16 Jul 2012 20:19:13 GMT

- incremented the minor version number of the pspx module

Source code checked in, #18026

poshoholic — Mon, 16 Jul 2012 18:55:35 GMT

- minor fix to add a newline to a proxy function that is generated where one was not being added before

Source code checked in, #18022

poshoholic — Mon, 16 Jul 2012 16:04:27 GMT

- converted a few commands that were not using fully-qualified names into fully-qualified names - replaced spaces with tabs where appropriate - fixed logic that generates parameter position values for commands and help; help-position is 1-based, command-position is 0-based - added support for defining a parameter position as "named" - fixed logic that generates maml help xml so that the syntax and parameters are written to the xml in the correct order (this directly impacts how they appear when users look up help for a command)