PowerShell v3 Using Visio to Display Cmdlets by Noun

To get a better grip on what all exists in the new v3 command space, I wanted to know what I could do with the Get-Command cmdlet in order to get things grouped by Noun. If this is unfamiliar to you, all cmdlets have two parts in their name as a part of the cmdlet design philosophy:

• Verb
• Noun

In the case of Get-Item, the verb is Get and the noun is Item. And, Send-MailMessage has a verb of Send and noun of MailMessage. So, whatever preceeds the dash is the verb and whatever follows is the noun. Fine. Obvious. Duh. I want to do something with this though. And, Visio is coming to mind. So, I need to get my data organized, then, I want a new chart. Thats a little more ambitious. 

Ok. Lets see about step 1: organizing the data. To get around the organization I came up with a four step command that:

1. Gets the cmdlets
2. Selects their full name and noun
3. Groups the list based on nouns
4. Selects (and expands) the groups once sorted

The command looks like this:

Get-Command-CommandType cmdlet|

selectName,@{e={($_.name -split -)[1]};N=Noun} |

groupNoun |

select-ExpandProperty Group

Easy enough. When I run this, just to give a sample, the first 10 lines looks like this:

Add-BitsFile           BitsFile 

Add-Computer           Computer 

Checkpoint-Computer    Computer 

Remove-Computer        Computer 

Rename-Computer        Computer 

Restart-Computer       Computer 

Restore-Computer       Computer 

Stop-Computer          Computer 

Add-Content            Content  

Clear-Content          Content  

Get-Content            Content  

Set-Content            Content 

Cool. Organized, simple, straightforward. Now, for the fun part...i.e., the new puzzle. How can I get these guys into a pretty format in Visio? Or, maybe Word. Ill start with Visio. Using Eds post

Hey, Scripting Guy! Is It Possible to Automate Microsoft Visio?

I was able to come up with something basic, but, it still did not have any kind of decent formatting. It simply put grouped output into rectangles in a Visio document. As I get further into the Visio object model I will try to find a clean, prettier way to put all this together. At the moment, all it does is dump them into a document. Ill actually need to move things around. For now, thats a good bit of time saved. Getting a pretty, well-formed script that really organizes this is probably a round 2 of this effort.

# Instantiate new Visio document

$application = New-Object -ComObject Visio.Application

# Add document to application

$documents = $application.Documents

# Open basic diagram template

$document = $documents.Add(Basic Diagram.vst)

# Select active document page

$pages = $application.ActiveDocument.Pages

# Select first page

$page = $pages.Item(1)

# Select basic shapes stencil

$stencil = $application.Documents.Add("Basic Shapes.vss")

# Get list of cmdlets and group by noun

Get-Command -CommandTypecmdlet |

Sort Noun|

Group noun|

ForEach-Object {

    # Build label

    $output+= "$($_.Name)`n"

    ForEach-Object{

        # Check to see if group has more than 1 cmdlet

        if($_.Group.Name.Count -gt 1)

        {

            ($_.Group.Name -split `n) |

            ForEach-Object{

                # Add cmdlet names to label with new line per cmdlet

                $output+= + $_ + "`n"

            }

        }

        else

        {

            # Add cmdlet names to label

            $output+= + $_.Group.Name

        }

    }

    # Create new square

    $item = $stencil.Masters.Item("Rectangle")

    # Drop square on page

    $shape= $page.Drop($item, 1.0, 10.6)

    # Set text to current group name

    $shape.Text = $output

About lamsim

Author Description here.. Nulla sagittis convallis. Curabitur consequat. Quisque metus enim, venenatis fermentum, mollis in, porta et, nibh. Duis vulputate elit in elit. Mauris dictum libero id justo.

Subscribe to this Blog via Email :