In a Tweet, Jeffrey Snover was asking if the community had anything to say to make Powershell better. This kind of tweet may not be very easy to answer in 280 characters, but if you take time to think about it, it interrogates the way you’re using the language. Did you in fact make your scripts powershellic ? Do you have issues with some edge cases of the language grammar ? Are some various commonly used cmdlets not well aligned with the language’s spirit, whether they are built-in or comes from well-known packages.
Before digging into the language in a future post, let’s start first by a very annoying cmdlet for the system administrator: New-SmbMapping. Whether your sysadmin experiment started before or with Powershell, this cmdlet does not align with the rest of the commands you’re used to run. The issue lies in the management of the credentials, as you often use alternate credentials to connect to the target share.
If you are Powershell savvy, credentials mean PSCredential, so you’ll be surprised the first time you try to auto-complete this cmdlet, when nothing comes up which starts with ‘C’.
You’ll soon discover that the two options to use are UserName and Password.
You wonder then why you were told to always use Get-Credential to request sensitive information, and why here your password becomes a simple string, especially when in comparison you’re warned when doing the same plain text password thing in Desired State COnfiguration files
But that’s not the first surprise you will encounter. Naively you tell yourself that this parameter naming convention is used because the cmdlet mimics the legacy net use command. Therefore you try to input only a username to get prompted for a password. Doesn’t work.
Familiar with similar but not equivalent net related commands, you try to use a star as a password. Doesn’t work either. You’ll get the same error. Since criticism without enhancement proposal would be useless, here is a modified version of New-SmbMapping which proxies the current existing version.
function New-SmbMappingEx {
[CmdletBinding(SupportsShouldProcess=$true, ConfirmImpact='Medium', PositionalBinding=$false, HelpUri='http://go.microsoft.com/fwlink/?LinkID=241956')]
param(
[Parameter(ParameterSetName='Create0', Position=1)]
[ValidateNotNull()]
[AllowEmptyString()]
[string]
${LocalPath},
[Parameter(ParameterSetName='Create0', Position=2)]
[ValidateNotNull()]
[AllowEmptyString()]
[string]
${RemotePath},
[Parameter(ParameterSetName='Create0')]
[PSCredential]
${Credential},
[Parameter(ParameterSetName='Create0')]
[bool]
${Persistent},
[Parameter(ParameterSetName='Create0')]
[switch]
${SaveCredentials},
[Parameter(ParameterSetName='Create0')]
[switch]
${HomeFolder},
[Parameter(ParameterSetName='Create0')]
[Alias('Session')]
[ValidateNotNullOrEmpty()]
[CimSession[]]
${CimSession},
[Parameter(ParameterSetName='Create0')]
[int]
${ThrottleLimit},
[Parameter(ParameterSetName='Create0')]
[switch]
${AsJob})
begin
{
try {
$outBuffer = $null
if ($PSBoundParameters.TryGetValue('OutBuffer', [ref]$outBuffer))
{
$PSBoundParameters['OutBuffer'] = 1
}
$wrappedCmd = $ExecutionContext.InvokeCommand.GetCommand('New-SmbMapping', [System.Management.Automation.CommandTypes]::Function)
if ($PSBoundParameters.ContainsKey('Credential')) {
[void] $PSBoundParameters.Remove('Credential')
$scriptCmd = {& $wrappedCmd @PSBoundParameters -Password ($credential.GetNetworkCredential().Password) -Username $credential.Username }
} else {
$scriptCmd = {& $wrappedCmd @PSBoundParameters }
}
$steppablePipeline = $scriptCmd.GetSteppablePipeline()
$steppablePipeline.Begin($PSCmdlet)
} catch {
throw
}
}
process
{
try {
$steppablePipeline.Process($_)
} catch {
throw
}
}
end
{
try {
$steppablePipeline.End()
} catch {
throw
}
}
}
<#
.ForwardHelpTargetName New-SmbMapping
.ForwardHelpCategory Function
#>
Here is a proxy command which uses Credential as
After this post about a Microsoft issued cmdlet not following Microsoft best practices, next post will discuss a language construction.