diff --git a/Docs/Advanced.md b/Docs/Advanced.md index c8021ae..0752b9b 100644 --- a/Docs/Advanced.md +++ b/Docs/Advanced.md @@ -5,7 +5,7 @@ There are various options for using PeterDocs. The following sections will cove ## File Filter The ``-FileFilter`` parameter allows selection of files that are to be included into the archive file. -The parameter only applies to the compress function or buidling the reconciliation file. +The parameter only applies to the compress function or building the reconciliation file. For example: @@ -23,7 +23,7 @@ will only include files with the extension ".jpg" and starting with the characte ## ReconcileFile -The ``-ReconcileFile`` parameter allows specification of the reocnciliation file if you +The ``-ReconcileFile`` parameter allows specification of the reconciliation file if you wish to select your own name. For example: @@ -67,7 +67,7 @@ includes the date. ## Compression Level By setting the Compression level to a value recognized by the 7Zip4Powershell module you can gain more control -of the compresison. The main use case here is for documents that are already compressed and would +of the compression. The main use case here is for documents that are already compressed and would not benefit from future compression. To use this feature you need to set the environment variable. If all documents are JPEG pictures then setting this value can speed up the compress process diff --git a/Docs/AlternateUses.md b/Docs/AlternateUses.md index 9872f48..c97cea1 100644 --- a/Docs/AlternateUses.md +++ b/Docs/AlternateUses.md @@ -11,7 +11,7 @@ You can use ``PeterDocs`` to reconcile files transferred using the Windows system. Robocopy does require your source and target folders to be accessible from -the coputer that is executing the command. +the computer that is executing the command. To use ``PeterDocs`` and ``Robocopy`` install PeterDocs from the PowerShell Gallery and execute the below commands in a PowerShell terminal, changing the values to suit. @@ -52,7 +52,7 @@ below command in a PowerShell terminal, changing the values to suit. New-PeterReconcile -ReconcileFile .\mypictures_metadata.csv -SourceFolder -ExcludeHash -IncludeExif ``` -At the conclusion of the exceution, you will have a file named ``##peter_exif##.csv`` that +At the conclusion of the execution, you will have a file named ``##peter_exif##.csv`` that contains your pictures metadata. You will also have a CSV file with picture file general metadata named ``mypictures_metadata.csv`` such as creation time and size. diff --git a/Docs/Compress.md b/Docs/Compress.md index 146e123..7668e2c 100644 --- a/Docs/Compress.md +++ b/Docs/Compress.md @@ -7,7 +7,7 @@ or cloned to a remote location securely. The documents can be binary or text do including personal photographs or sensitive Microsoft Word documents. At the remote location a reconciliation can be performed to verify that the documents -have been recieved and no alteration occurred. +have been received and no alteration occurred. ## Why @@ -49,7 +49,7 @@ You can ignore the remaining parameters if you are happy with the defaults. ## What -The ```Compress-Peter``` compressess the contet of the ```SourceFolder``` and saves the result +The ```Compress-Peter``` compresses the content of the ```SourceFolder``` and saves the result as the encrypted ```ArchiveFile```. The archive file also contains the reconciliation file so that the recipient of the archive is able to reconcile the restore at the remote location. @@ -67,7 +67,7 @@ generate delta archive files. ## Send Usage -Once the archive file is created you will commonly send or transfer it to anohter +Once the archive file is created you will commonly send or transfer it to another location where it wll be unpacked. Please read next the documentation on [sending the archive](SendArchive.md) diff --git a/Docs/Design.md b/Docs/Design.md index 236b311..0c2d803 100644 --- a/Docs/Design.md +++ b/Docs/Design.md @@ -3,7 +3,7 @@ ## Objective The objective is to provide a simple capability to create a secure -archive file containiung documents to be restored and reconciled at the destination. +archive file containing documents to be restored and reconciled at the destination. The design artefacts must provide all the tools required to pack, secure, unpack and reconcile the restored/cloned documents. diff --git a/Docs/Encryption.md b/Docs/Encryption.md index dc09c13..223c64c 100644 --- a/Docs/Encryption.md +++ b/Docs/Encryption.md @@ -22,7 +22,7 @@ encryption. The secret (or password) needs to be complex and at least The complex secret needs to contain lower case letter, upper case letter, numeric digit and special symbol. -The secret is used directly on the 7ZIP compresison and you can use the +The secret is used directly on the 7ZIP compression and you can use the secret to decrypt the archive file and check its contents. Make a note of the secret as you will need it to decrypt the contents. @@ -34,10 +34,10 @@ file itself. ## RecipientKey The PeterDocs parameter labelled ```RecipientKey``` is used for asymmetric -keys provided by the Microsft Certificate Manager for encrypting content. +keys provided by the Microsoft Certificate Manager for encrypting content. This is the most secure method for transfer as it is secured with the -certficates. Using certificates requires: +certificates. Using certificates requires: 1. your recipient to send you their public certificate 2. you to load the public certificate into your Windows Certificate Manager @@ -49,7 +49,7 @@ contents. The recipient will need to receive the archive file plus the ```.key``` file generated by PeterDocs. Both files must be accessible to the -recipient for decryptingg the contents. +recipient for decrypting the contents. ### Internal process @@ -58,7 +58,7 @@ is saved into the ```.key``` file which is encrypted using the recipients public key. The reason for doing this process is because there are technical limitations -in encrypting large files using the certficate public keys. The maximum +in encrypting large files using the certificate public keys. The maximum size is around 60MB when using public keys. ### Generating your Certificate @@ -70,7 +70,7 @@ Manager or executing the below PowerShell command. New-SelfSignedCertificate -Subject "CN=PeterDocs" -FriendlyName "PeterDocs" -KeyDescription "Encryption key for PeterDocs data encipherment" -CertStoreLocation "Cert:\CurrentUser\My" -KeyUsage KeyEncipherment,DataEncipherment, KeyAgreement -Type DocumentEncryptionCert ``` -To list your current certficates use the below PowerShell command. +To list your current certificates use the below PowerShell command. ```powershell Get-Childitem -Path "Cert:\CurrentUser\My" -DocumentEncryptionCert diff --git a/Docs/Expand.md b/Docs/Expand.md index 2d445f7..28fc1de 100644 --- a/Docs/Expand.md +++ b/Docs/Expand.md @@ -36,7 +36,7 @@ To expand the archive you will need write access to the ```RestoreFolder``` loca ## What The ```Expand-Peter``` decrypts the archive file and expands the contents into -the specified restore folder. It does not peform a reconciliation which is the +the specified restore folder. It does not perform a reconciliation which is the next step. ## Reconcile Usage diff --git a/Docs/Install.md b/Docs/Install.md index 5fbc4ee..1e8cc2a 100644 --- a/Docs/Install.md +++ b/Docs/Install.md @@ -1,6 +1,6 @@ # Install -PeterDocs is a module that can be donwloaded or installed from +PeterDocs is a module that can be downloaded or installed from [PowerShell Gallery](https://xx.com/) ## Pre-requisites @@ -43,7 +43,7 @@ On a **computer with Internet (PowerShell Gallery) access** do the following ste 1. First check you have PowerShell version 5 or later ```powershell -$PSVersionTabe.PSVersion +$PSVersionTable.PSVersion ``` 2. Download the PeterDocs module @@ -63,7 +63,7 @@ On the **computer lacking Internet (PowerShell Gallery) access** do the followin 1. First check you have PowerShell version 5 or later ```powershell -$PSVersionTabe.PSVersion +$PSVersionTable.PSVersion ``` 2. Run the following command to determine where the ZIP needs to be unpacked diff --git a/Docs/ReceiveArchive.md b/Docs/ReceiveArchive.md index f8a763d..6999ecf 100644 --- a/Docs/ReceiveArchive.md +++ b/Docs/ReceiveArchive.md @@ -3,13 +3,13 @@ ## Why Once the archive file is sent, you need to download it from its intermediate -location if the source and destination locations are not directky connected. +location if the source and destination locations are not directly connected. You can user other tools you have available to download the archive file. ## When -The archive is received after it sent. The assunmption is that cloud storage +The archive is received after it sent. The assumption is that cloud storage is being used as an intermediary. ## How @@ -36,8 +36,8 @@ The ```SourcePath``` is specified as follows: The "s3" prefix is to download from AWS S3. The "b2" prefix is to download from Backblaze. -If you are dowloading from AWS you can specify the AWS profile name -in parameter ```SourceProfile```. In this situtation the profile +If you are downloading from AWS you can specify the AWS profile name +in parameter ```SourceProfile```. In this situation the profile needs to exist in the AWS credentials on your local device and user profile. If you are downloading from Backblaze you specify the ```AccountId``` and the @@ -57,7 +57,7 @@ use other tools to download the archive file and the key file. The function will not expand or reconcile the restore at the destination. -Please ensure you have sufficent storage to accomodate the local copy of the +Please ensure you have sufficient storage to accommodate the local copy of the archive and space to unpack it. ## Expand Usage diff --git a/Docs/Reconcile.md b/Docs/Reconcile.md index 01e5431..6422be8 100644 --- a/Docs/Reconcile.md +++ b/Docs/Reconcile.md @@ -4,7 +4,7 @@ A reconcile file is generated as part of the Compress process and packed with th ## Why -When transferring or cloning documenmts to another location, you will want to +When transferring or cloning documents to another location, you will want to verify that the same documents have been restored unaltered at the destination. ## When @@ -44,7 +44,7 @@ The document last update and time is not checked because the value will reflect the date and time of restore. The reconciliation summary is displayed in the terminal and the log -wil lhave more information. +will have more information. If any errors are listed, please investigate the discrepancy. diff --git a/Docs/SendArchive.md b/Docs/SendArchive.md index 6512e7f..2ae90bd 100644 --- a/Docs/SendArchive.md +++ b/Docs/SendArchive.md @@ -43,7 +43,7 @@ The "s3" prefix is to upload to AWS S3. The "b2" prefix is to upload to Backblaze. If you are uploading to AWS you can specify the AWS profile name -in parameter ```TargetProfile```. In this situtation the profile +in parameter ```TargetProfile```. In this situation the profile needs to exist in the AWS credentials on your local device and user profile. If you are uploading to Backblaze you specify the ```AccountId``` and the diff --git a/Docs/Usage.md b/Docs/Usage.md index c32e82e..ef309c3 100644 --- a/Docs/Usage.md +++ b/Docs/Usage.md @@ -75,4 +75,4 @@ PeterTask ``` **NOTE** Please do not use the VolumeSize parameter as it will fail due to a current -issue with the underlying 7zip4 Powershell module. \ No newline at end of file +issue with the underlying 7zip4 Powershell module. diff --git a/README.md b/README.md index 08b1ff7..80ffbe0 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# PeterDocs - Protect, Transfer, Reconcile Dcouments +# PeterDocs - Protect, Transfer, Reconcile Documents ## Summary @@ -14,7 +14,7 @@ that execute the code are required to have Windows PowerShell installed. Use the script to create an encrypted archive of the source folder and its contents, then transfer the archive file to your target, where the content are unpacked using the decryption key. After archive contents are restored you can execute the reconcile function -to veriy that the contents are transferred, unaltered. +to verify that the contents are transferred, unaltered. See [Quick Start](QuickStart.md) if you are ready to start and don't need the details. @@ -90,11 +90,11 @@ will need write access on the target storage. A log file is written at execution to record activity. Your bulk file transfer is encrypted in transit. Note that if you use the -SecretKey method the ecnrypted contents will only be as secure as the strength +SecretKey method the encrypted contents will only be as secure as the strength of your secret. You can use storage providers such as Dropbox, AWS S3, Google Drive, OneDrive or BackBlaze -and your documents have additonal protection. +and your documents have additional protection. A log file is produced on execution. Repeated executions on the same day will add text content to the same log file. The default log name takes the form: