Publish version 1.0.x (#45)

## About

## Content (Micro Commits)

* fixes #38 
* fixes #44 
* Implement precise lookup hierarchy (fixes #43)
* align pester test with #43 logic
* split cert functions
* use new cert functions for save an lookup
* fix pester tests
* [wip]
* fix var name ref
* fix exports
* fix cert store location for windows shared mode
* fix mandatory params
* fix accidentially removed code block
* add basic cert pester pests
* remove old docs
* update cbh blocks
* update cbh blocks
* update docs
* move .net wrapper forpfx files
* do not export .net wrapper functions
* update docs
* rename tests
* fix private functions location
* - fixes #44: FTP connection
* add link to reference
* add format files
* add preview version shield
* update markdown help files (platyps)
* add emoji images in captions
* fix typos
* fix typos
* fix typo
* prepare version numbers

src/Certificate/Import-CSCertificate.ps1

@@ -1,18 +1,17 @@
 function Import-CSCertificate {
     <#
     .SYNOPSIS
-        adds a given pfx certificate file to current uerers personal certificate store.
+        Imports a linked certificate to the valid store location.
 
     .DESCRIPTION
-        This function is used to import existing pfx certificate files. The Import-PFXCertificate cmdle from the
-        PKI module imports the certficate into a deprecated store. Thus you can't read the private key afterwards or
-        using it for decrypting data.
+        Import-CSCertificate takes a pfx certificate file and imports it to the supposed certificate store for
+        private and shared credential stores.
+
+    .PARAMETER Type
+        Select between the a private and shared credential store.
 
     .PARAMETER Path
-        Path to an existing *.pfx certificate file.
-
-    .PARAMETER StoreName
-        Additionally you change change the store where you want the certificate into.
+        Provide a valid path to pfx certificate file.
 
     .INPUTS
         [None]
@@ -21,12 +20,12 @@ function Import-CSCertificate {
         [None]
 
     .EXAMPLE
-        Import-CSCertificate -Path (Join-Path -Path $Env:APPDATA -ChildPath '/PSCredentialStore.pfx')
+        Import-CSCertificate -Type 'Private' -Path (Join-Path -Path $Env:APPDATA -ChildItem 'PfxCertificate.pfx')
 
     .NOTES
-        File Name   : Import-CSCertificate.ps1
-        Author      : Marco Blessing - marco.blessing@googlemail.com
-        Requires    :
+        - File Name   : Import-CSCertificate.ps1
+        - Author      : Marco Blessing - marco.blessing@googlemail.com
+        - Requires    :
 
     .LINK
         https://github.com/OCram85/PSCredentialStore
@@ -36,77 +35,38 @@ function Import-CSCertificate {
     param(
         [Parameter(Mandatory = $true)]
         [ValidateNotNullOrEmpty()]
-        [string]$Path,
+        [ValidateSet('Private', 'Shared')]
+        [string]$Type,
 
-        [Parameter(Mandatory = $false)]
-        [ValidateSet(
-            'AddressBook',
-            'AuthRoot',
-            'CertificateAuthority',
-            'Disallowed',
-            'My',
-            'Root',
-            'TrustedPeople',
-            'TrustedPublisher'
-        )]
-        [string]$StoreName = 'My',
+        [Parameter(Mandatory = $true)]
+        [ValidateNotNullOrEmpty()]
+        [System.IO.FileInfo]$Path
 
-        [Parameter(Mandatory = $false)]
-        [ValidateSet(
-            'CurrentUser',
-            'LocalMachine'
-        )]
-        [string]$StoreLocation = 'CurrentUser',
-
-        [Parameter(Mandatory = $false)]
-        [ValidateSet(
-            'ReadOnly',
-            'ReadWrite',
-            'MaxAllowed',
-            'OpenExistingOnly',
-            'InclueArchived'
-        )]
-        [string]$OpenFlags = 'ReadWrite'
     )
     begin {
-        $Store = [System.Security.Cryptography.X509Certificates.X509Store]::new($StoreName, $StoreLocation)
-        try {
-            $Store.Open($OpenFlags)
-        }
-        catch {
-            $_.Exception.Message | Write-Error -ErrorAction Stop
-        }
-    }
-    process {
-        try {
-            $cert = [System.Security.Cryptography.X509Certificates.X509Certificate2]::new(
-                $Path,
-                $null,
-                (
-                    [System.Security.Cryptography.X509Certificates.X509KeyStorageFlags]::Exportable -bor
-                    [System.Security.Cryptography.X509Certificates.X509KeyStorageFlags]::PersistKeySet
-                )
-            )
-
-            if (Test-CSCertificate -Thumbprint $cert.Thumbprint) {
-                Write-Warning -Message ('The certificate with thumbprint {0} is already present!' -f $cert.Thumbprint)
-            }
-            else {
-                $Store.Add($cert)
-            }
-        }
-        catch {
-            $_.Exception.Message | Write-Error -ErrorAction Stop
+        if (! (Test-Path -Path $Path)) {
             $ErrorParams = @{
                 ErrorAction = 'Stop'
                 Exception   = [System.Exception]::new(
-                    'Could not read or add the pfx certificate!'
+                    ('File {0} not found!') -f $Path
                 )
             }
             Write-Error @ErrorParams
         }
     }
+
+    process {
+        # Import to CurrentUser\My store for windows and linux
+        if ($Type -eq 'Private') {
+            Import-CSPfxCertificate -Path $Path -StoreName 'My' -StoreLocation 'CurrentUser' -OpenFlags 'ReadWrite'
+        }
+        elseif ( (! $isLinux ) -and ($Type -eq 'Shared') ) {
+            Import-CSPfxCertificate -Path $Path -StoreName 'My' -StoreLocation 'LocalMachine' -OpenFlags 'ReadWrite'
+        }
+        elseif ( ($isLinux) -and ($Type -eq 'Shared') ) {
+            Import-CSPfxCertificate -Path $Path -StoreName 'My' -StoreLocation 'CurrentUser' -OpenFlags 'ReadWrite'
+        }
+    }
     end {
-        $Store.Close()
     }
 }