Public/Get-MDSCredential.ps1
|
Function Get-MDSCredential { <# .SYNOPSIS Get a stored credential or list all stored credentials. .DESCRIPTION Get a stored credential or list all stored credentials. A dynamic parameter of 'Name' allows for tab completion of available credentials. .EXAMPLE Get-MDSCredential -Name MyCred1 Get a stored credential .EXAMPLE Invoke-Command -ComputerName Computer01 -Credential (Get-MDSCredential -Name MyCred1) -ScriptBlock {Get-Service} Use a stored credential to populate another cmdlet's credential parameter .EXAMPLE Get-MDSCredential -ListAvailable Disable a single service plan for a single user .EXAMPLE Get-MDSCredential -SortByName Disable a single service plan for a single user .NOTES #> [cmdletbinding(DefaultParameterSetName='Default',PositionalBinding=$False)] Param ( [parameter(ParameterSetName='Default')] [switch]$ListAvailable, [parameter(ParameterSetName='Sort')] [switch]$SortByName ) DynamicParam { # Execute a Test-Path to avoid dynamic parameter creation errors If ((Test-Path $CredentialFilePath) -eq $True) { $Options = @( Import-CliXML $CredentialFilePath -ErrorAction Stop | Select-Object -ExpandProperty Keys | Sort-Object ) New-DynamicParam -Name 'Name' -ValidateSet $Options -Position 0 -ParameterSetName 'Name' } } Begin { $Name = $PSBoundParameters.Name } Process { If ((Test-Path $CredentialFilePath) -eq $False) { Write-Warning "Please use 'Add-MDSCredential' to populate your credential store." Return } Try { $CredentialFile = Import-CliXML $CredentialFilePath -ErrorAction Stop } Catch { $PSCmdlet.ThrowTerminatingError($PSItem) } If ($Name) { If ($CredentialFile[$Name]) { Write-Verbose "MDSCredential found for $($Name)" $MDSCredentialEntry = $CredentialFile[$Name] } Else { Return Write-Error -Message "MDSCredential not found for $($Name)" } Return New-Object -TypeName System.Management.Automation.PsCredential -ArgumentList $MDSCredentialEntry[0],($MDSCredentialEntry[1] | ConvertTo-SecureString) } If ($PSCmdlet.ParameterSetName -eq 'Default' -or $SortByName -eq $True) { Return $CredentialFile.GetEnumerator() | Sort-Object Name } Return $CredentialFile } End {} } |