Publish Pre-release (#1)

* adds basic module layout * fix module manifest encoding * fix callsign in appveyor helper * adds challenge file related functions * adds connection manager functions * adds Test-ChallengeFile * adds item related functions * adds store related functions * adds cSpell dictionary * adds CredentialStore related Pester tests * [WIP] test Pester file * fix typo * adds file dependencies * [WIP] fix pester tests * fix exception state * [WIP] add file dependencies * fix gitkeep filename * set constant debug module version string * adds Pester Tests for New-CredentialStoreItem * adds basic readme file * adds functions to export; adds meta data * adds vscode debug config * adds test for optional dependencies * [WIP] Implements optional dependency test * adds taskrunner definitions * adds CBH * add gitignore file * adds basic Build tasks * typo fixed * adds build folder to ignore list * adds Cisco and NetApp opt dependencies * adds build task * fix end of line dequence * remove task.json error * adds sources for optional modules * enables Pester and posh-git * prepare pre-release
2017-09-21 13:32:15 +02:00
parent 5ebba20cea
commit 64af16cc08
37 changed files with 2503 additions and 1 deletions
--- a/src/Item/Test-CredentialStoreItem.ps1
+++ b/src/Item/Test-CredentialStoreItem.ps1
@ -0,0 +1,93 @@
+function Test-CredentialStoreItem() {
+    <#
+    .SYNOPSIS
+        Checks if the given RemoteHost identifier combination exists in the credential store.
+
+    .DESCRIPTION
+        Use this cmdlet for basic checks with a single item. Check the item first with this function before
+        you try to interact with it.
+
+    .PARAMETER Path
+        Define a custom credential store you try to read from. Without the `-Path` parameter
+        `Test-CredentialStoreItem` tries to read from the default private store.
+
+    .PARAMETER RemoteHost
+        Specify the host, for which you would like to change the credentials.
+
+    .PARAMETER Identifier
+        Adds an optional identifier to the given RemoteHost. Makes it possible to store multiple credentials
+        for a single host.
+
+    .PARAMETER Shared
+        Switch to shared mode with this param. This enforces the command to work with a shared CredentialStore which
+        can be decrypted across systems.
+
+    .INPUTS
+        [None]
+
+    .OUTPUTS
+        [None]
+
+    .EXAMPLE
+        If (Test-CredentialStoreItem -RemoteHost "Default") {
+            Get-CredentialStoreItem -RemoteHost "Default"
+        }
+        Else {
+            Write-Warning ("The given Remote Host {0} does not exist in the credential Store!" -f $RemoteHost)
+        }
+
+    .NOTES
+        File Name   : Test-CredentialStoreItem.ps1
+        Author      : Marco Blessing - marco.blessing@googlemail.com
+        Requires    :
+
+    .LINK
+        https://github.com/OCram85/PSCredentialStore
+    #>
+    [CmdletBinding(DefaultParameterSetName = "Private")]
+    [OutputType([Boolean])]
+    param(
+        [Parameter(Mandatory = $false, ParameterSetName = "Shared")]
+        [string]$Path = "{0}\PSCredentialStore\CredentialStore.json" -f $env:ProgramData,
+
+        [Parameter(Mandatory = $true)]
+        [ValidateNotNullOrEmpty()]
+        [string]$RemoteHost,
+
+        [Parameter(Mandatory = $false)]
+        [ValidateNotNullOrEmpty()]
+        [string]$Identifier,
+
+        [Parameter(Mandatory = $false, ParameterSetName = "Shared")]
+        [switch]$Shared
+    )
+
+    if ($PSCmdlet.ParameterSetName -eq "Private") {
+        $Path = "{0}\CredentialStore.json" -f $env:APPDATA
+    }
+
+    if ($Identifier -ne "") {
+        $CredentialName = $RemoteHost = "{0}/{1}" -f $Identifier, $RemoteHost
+    }
+    else {
+        $CredentialName = $RemoteHost
+    }
+
+    if (Test-CredentialStore -Path $Path) {
+        $CS = Get-CredentialStore -Path $Path
+        $CSMembers = Get-Member -InputObject $CS
+        if (($CSMembers.MemberType -eq "NoteProperty") -and ($CSMembers.Name -eq $CredentialName)) {
+            return $true
+        }
+        else {
+            return $false
+        }
+    }
+    else {
+        $MsgParams = @{
+            ErrorAction = "Stop"
+            Message = "The given credential store ({0}) does not exist!" -f $Path
+        }
+        Write-Error @MsgParams
+    }
+}