Citrix StoreFront SDK PowerShell Modules

Unprotect-STFConfigurationExport

Creates a decrypted copy of the supplied ctxzip file containing configuration elements that form a Citrix StoreFront deployment using the supplied PSCredential.

Syntax

Unprotect-STFConfigurationExport -EncryptedConfigurationZip <String> -Credential <PSCredential> -OutputFolder <String> [<CommonParameters>]
<!--NeedCopy-->

Detailed Description

Creates a decrypted copy of the supplied ctxzip file containing configuration elements that form a Citrix StoreFront deployment using the supplied PSCredential.

Parameters

Name Description Required? Pipeline Input Default Value
EncryptedConfigurationZip The path to the backup archive WITH its correct file extension .ctxzip true true (ByValue)  
Credential A predefined PowerShell credential object containing the same password that was used to export the backup archive. true false  
OutputFolder The folder that the resultant decrypted configuration zip file should be saved to. true false  

Input Type

System.String

Parameter EncryptedConfigurationZip: The .NET System.String reference type

System.Management.Automation.PSCredential

Parameter Credential: The .NET System.Management.Automation.PSCredential reference type

System.String

Parameter OutputFolder: The .NET System.String reference type

Return Values

None

Examples

EXAMPLE 1 Decrypt Config Export

Unprotect-STFConfigurationExport -EncryptedConfigurationZip "$env:userprofile\desktop\ConfigBackup.ctxzip" -Credential $CredObject -OutputFolder 'C:\exampleFolder\exampleSubfolder' -Force
<!--NeedCopy-->

REMARKS

Using the password supplied in $CredObject this will decrypt and convert the ConfigBackup.ctxzip backup archive to an unencrypted .zip backup archive and save it to C:\exampleFolder\exampleSubfolder\ConfigBackup.zip overwriting any existing ConfigBackup.zip files that may exist at that location.

Example PSCredential:

$User = Any non empty string will suffice here. The exported configuration is secured by only using the $Password.

$Password = ‘Secret’

$Password = $Password ConvertTo-SecureString -asPlainText -Force

$CredObject = New-Object System.Management.Automation.PSCredential($User,$Password)

Create a PowerShell credential object containing a username and password for symmetric encryption and decryption of configuration backup archives. PowerShell credential objects store passwords as secure strings in memory.

The user is irrelevant but mandatory to create a PowerShell credential object. The example code uses the currently logged in user.

The password is used for symmetric encryption/decryption of the backup archive. NOTE: The password DOES NOT need to match the user’s password to create a valid credential object.

Unprotect-STFConfigurationExport