Restore-WFFarm

Updated: August 10, 2012

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Restore-WFFarm

This cmdlet is used in disaster recovery scenarios to set up the farm using recovered databases.

Syntax

Parameter Set: AutoCert
Restore-WFFarm -CertificateAutoGenerationKey <SecureString> -InstanceDBConnectionString <String> -ResourceDBConnectionString <String> -WFFarmDBConnectionString <String> [-AdminGroup <String> ] [-ConsistencyVerifierLogPath <String> ] [-HttpPort <Int32> ] [-HttpsPort <Int32> ] [-InstanceStateSyncTime <DateTime> ] [-RunAsAccount <String> ] [ <CommonParameters>]

Parameter Set: CustomCert
Restore-WFFarm -InstanceDBConnectionString <String> -OutboundCertificateThumbprint <String> -ResourceDBConnectionString <String> -SslCertificateThumbprint <String> -WFFarmDBConnectionString <String> [-AdminGroup <String> ] [-ConsistencyVerifierLogPath <String> ] [-EncryptionCertificateThumbprint <String> ] [-HttpPort <Int32> ] [-HttpsPort <Int32> ] [-InstanceStateSyncTime <DateTime> ] [-RunAsAccount <String> ] [ <CommonParameters>]




Detailed Description

Run Restore-WFFarm in disaster recovery scenarios to set up the farm using recovered databases.

Parameters

-AdminGroup<String>

Represents the set of users who are considered workflow administrators.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-CertificateAutoGenerationKey<SecureString>

This represents the password that will be used to securely store the auto generated certificate in the database.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ConsistencyVerifierLogPath<String>

Aliases

LogFilePath

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-EncryptionCertificateThumbprint<String>

This certificate is used for securing the SQL connection strings. If not provided, it will take the value of the SslCertificate. Represents the encryption certificate.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-HttpPort<Int32>

The port number used for HTTP communication.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-HttpsPort<Int32>

The port number used for HTTPS communication.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-InstanceDBConnectionString<String>

Represents the connection string of the gateway database.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-InstanceStateSyncTime<DateTime>

Aliases

syncTime

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-OutboundCertificateThumbprint<String>

The certificate that will be used as the outbound certificate by Workflow Manager 1.0.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ResourceDBConnectionString<String>

Represents the connection string of the container database for Service Bus.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-RunAsAccount<String>

Represents the account under which the service will be running.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-SslCertificateThumbprint<String>

Represents the SSL certificate used by the workflow farm.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WFFarmDBConnectionString<String>

This represents the connection string of the database where all the configuration settings will be stored.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Notes

  • This cmdlet may timeout with a WFRuntimeSettingFailed exception. After this command is run, additional queries should be made to determine whether the operation was successful.

Examples

Example 1

Restore the workflow farm using recovered databases.


PS C:\> $CertKey=convertto-securestring 'CertificatePassword' -asplaintext-force;
Restore-WFFarm -ResourceMgmtDBConnectionString 'Data Source=SqlServerName;Initial Catalog=WfResourceDatabase;Integrated Security=True' -FarmMgmtDBConnectionString 'Data Source=SqlServerName;Initial Catalog=RecoverWFManagementDB;Integrated Security=True' -InstanceMgmtDBConnectionString 'Data Source=SqlServerName;Initial Catalog=WfInstanceDatabase;Integrated Security=True' -CertAutoGenerationKey $CertKey

Example 2

Restore the workflow farm using recovered databases.


PS C:\> $sec = ConvertTo-SecureString -Force -AsPlainText Password~1
Restore-AzureWFFarm -InstanceDBConnectionString "Data Source=localhost;Initial Catalog= WFInstanceManagementDB;Integrated Security=SSPI;Asynchronous Processing=True" -ResourceDBConnectionString "Data Source=localhost;Initial Catalog= WFResourceManagementDB;Integrated Security=SSPI;Asynchronous Processing=True" -InstanceStateSyncTime "June 28, 2012 12:30:00 PM" -ConsistencyVerifierLogPath "C:\ETH\AppFabricTemp\Textsec.txt" -WFFarmDBConnectionString "Data Source=localhost;Initial Catalog=WFManagementDB1;Integrated Security=SSPI;Asynchronous Processing=True" -Verbose -CertificateAutoGenerationKey $sec

Community Additions

ADD
Show: