This content has been machine translated dynamically.
Dieser Inhalt ist eine maschinelle Übersetzung, die dynamisch erstellt wurde. (Haftungsausschluss)
Cet article a été traduit automatiquement de manière dynamique. (Clause de non responsabilité)
Este artículo lo ha traducido una máquina de forma dinámica. (Aviso legal)
此内容已经过机器动态翻译。 放弃
このコンテンツは動的に機械翻訳されています。免責事項
이 콘텐츠는 동적으로 기계 번역되었습니다. 책임 부인
Este texto foi traduzido automaticamente. (Aviso legal)
Questo contenuto è stato tradotto dinamicamente con traduzione automatica.(Esclusione di responsabilità))
This article has been machine translated.
Dieser Artikel wurde maschinell übersetzt. (Haftungsausschluss)
Ce article a été traduit automatiquement. (Clause de non responsabilité)
Este artículo ha sido traducido automáticamente. (Aviso legal)
この記事は機械翻訳されています.免責事項
이 기사는 기계 번역되었습니다.책임 부인
Este artigo foi traduzido automaticamente.(Aviso legal)
这篇文章已经过机器翻译.放弃
Questo articolo è stato tradotto automaticamente.(Esclusione di responsabilità))
Translation failed!
Import-STFConfiguration
Imports a zip file containing configuration elements that form a Citrix StoreFront deployment. This zip file may be unencrypted in the form of a ‘.zip’ file or encrypted in the form of a ‘.ctxzip’.
Syntax
Import-STFConfiguration -ConfigurationZip <String> [-Credential <PSCredential>] [-HostBaseUrl <String>] [-SiteId <Int64>] [<CommonParameters>]
<!--NeedCopy-->
Detailed Description
Imports a zip file containing configuration elements that form a Citrix StoreFront deployment. This zip file may be unencrypted in the form of a ‘.zip’ file or encrypted in the form of a ‘.ctxzip’.
Related Commands
Parameters
| Name | Description | Required? | Pipeline Input | Default Value |
|---|---|---|---|---|
| ConfigurationZip | The name of the backup archive WITH its correct file extension such as .ctxzip or .zip. | true | false | |
| Credential | A predefined PowerShell credential object containing the same password that was used to export the backup archive. | false | false | |
| HostBaseUrl | Specify if you wish to use a HostBaseURL other than the one contained in the configuration backup you are importing. Mandatory if importing onto a factory default Storefront installation. | false | true (ByValue) | |
| SiteId | (DEPRECATED - The -siteId parameter is deprecated as of StoreFront 3.6 and is no longer required.) The IIS SiteID for the Storefront website. Typically 1. | false | false |
Input Type
System.String
Parameter ConfigurationZip: The .NET System.String reference type
System.Management.Automation.PSCredential
Parameter Credential: The .NET System.Management.Automation.PSCredential reference type
System.String
Parameter HostBaseUrl: The .NET System.String reference type
System.Int64
Parameter SiteId: The .NET System.Int64 value type
Return Values
None
Examples
EXAMPLE 1 Basic Config Import
Import-STFConfiguration -ConfigurationZip "$env:userprofile\desktop\ConfigBackup.zip"
<!--NeedCopy-->
REMARKS
This will import the ConfigBackup.zip configuration archive using the host base url and site id from the exported configuration.
EXAMPLE 2 Import Config to Configure an Unconfigured Machine
Import-STFConfiguration -ConfigurationZip "$env:userprofile\desktop\ConfigBackup.zip" -HostBaseUrl 'https://storefront.example.com'
<!--NeedCopy-->
REMARKS
Using the password supplied in $CredObject this cmdlet will decrypt and import the ConfigBackup.ctxzip backup archive using the host base url and site id from the exported configuration.
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.
Share
Share
In this article
This Preview product documentation is Citrix Confidential.
You agree to hold this documentation confidential pursuant to the terms of your Citrix Beta/Tech Preview Agreement.
The development, release and timing of any features or functionality described in the Preview documentation remains at our sole discretion and are subject to change without notice or consultation.
The documentation is for informational purposes only and is not a commitment, promise or legal obligation to deliver any material, code or functionality and should not be relied upon in making Citrix product purchase decisions.
If you do not agree, select I DO NOT AGREE to exit.