PowerShell Adapter Suggestions Supplier – PowerShell Workforce

Putting in PowerShell Adapter Suggestions Supplier

The discharge is out there from the PowerShell Gallery.

Use the next command to put in utilizing PowerShellGet v2.x:

Set up-Module -Title Microsoft.PowerShell.PSAdapter -AllowPrerelease

In case you are utilizing PSResourceGet, you need to use the next command:

Set up-PSResource -Title Microsoft.PowerShell.PSAdapter -AllowPrerelease

To make use of it it’s essential to import the module into your session:

Import-Module Microsoft.PowerShell.PSAdapter

We encourage you to incorporate this command in your $PROFILE in order that it’s loaded in each PowerShell
session you begin.

What are PowerShell Adapters?

A PowerShell Adapter is a script that converts the textual content output of a local executable and converts
it to PowerShell objects. The PowerShell Adapter module is a suggestions supplier that identifies these
scripts and offers ideas while you run the native command with none adapter script. You may
learn extra about suggestions suppliers in our weblog publish, What are suggestions suppliers?.

You may make PowerShell Adapters for any command. Simply use the precise identify of the command because the
prefix to the script in order that the module can determine the script and recommend it. For instance, you
should identify the script <identify of command>-adapter.ps1 in order that the PowerShell Adapter can determine it
as a adapter script. This script’s file location should included in your $env:PATH variable to be
discovered.

Creating an Adapter

For instance, you wish to use the macOS command vm_stat like a PowerShell object. Create a file
known as vm_stat-adapter.ps1 and add the placement of this file to your $env:PATH variable. The
PowerShell Adapter Suggestions Supplier will determine it as a attainable suggestion for vm_stat.

Right here is an instance PowerShell Adapter for vm_stat:

[CmdletBinding()]
param ( [Parameter(ValueFromPipeline=$true)][string]$inputObject )
BEGIN {
    $h = @{}
}

PROCESS {
    if ( $inputObject -match "^Mach Digital") {
        if ($inputObject -match "web page measurement of (d+) ") {
            $h['PageSize'] = [int]$matches[1]
        }
    }
    else {
        $okay,$v = $inputObject -split ":"
        $AdjustedK = ($okay -replace "[ -]","_").trim() -replace '"'
        $AdjustedV = "$v".Trim() -replace ".$"
        $h[$AdjustedK] = [int64]$AdjustedV
    }
}

END {
    [pscustomobject]$h
}

The next reveals the suggestion from the Suggestions Supplier while you run vm_stat with out the
adapter script:

For an additional instance, we will create a PowerShell Adapter for the df utility utilizing the TextUtility
PowerShell module. We simply have to create a df-adapter.ps1 script and embody the next:

$enter | ConvertFrom-TextTable -ConvertPropertyValue

Help for jc

The JSON Converter, jc, is a command line utility that converts textual content output to JSON for number of
command line instruments. The PowerShell Adapter module can recommend utilizing jc as an adapter if the consumer
has it put in. Whenever you use a command supported by jc, the PowerShell Adapter Suggestions Supplier
suggests utilizing jc piped to ConvertFrom-JSON.

You’ll find directions on easy methods to set up jc and extra particulars concerning the device of their
supply code repository. When jc helps the native command, this may be the best method
to transform the output without having to put in writing a PowerShell Adapter. You may see this suggestion in
the earlier screenshot for the df instance.

"arp", "cksum", "crontab", "date", "df", "dig", "dir", "du", "file", "finger",
"free", "hash", "id", "ifconfig", "iostat", "jobs", "lsof", "mount", "mpstat",
"netstat", "route", "stat", "sysctl", "traceroute", "uname", "uptime", "w", "wc",
"who", "zipinfo"

Predictive IntelliSense Help

We’ve additionally added Predictive IntelliSense help for the PowerShell Adapter suggestions supplier. With
Predictive IntelliSense enabled, the PowerShell Adapter Suggestions Supplier offers ideas that
Predictive IntelliSense will present you on the command line. This makes it simple to strive instantly,
moderately than manually operating the suggestion.

Suggestions

We actually appreciated the suggestions we obtained on the primary announcement of this device and would like to
proceed getting nice suggestions! The GitHub repository for this device remains to be named
JSONAdapters, nevertheless the module identify is Microsoft.PowerShell.PSAdapter and any reference to
this device shall be PowerShell Adapters going ahead. You may submit any suggestions to the
JsonAdapter repository.

Thanks a lot!

Steven Bucher

PowerShell Workforce