Export-IscsiTargetServerConfiguration

Exports an iSCSI Target Server configuration.

Syntax

Export-IscsiTargetServerConfiguration
      [-Filename] <String>
      [[-ComputerName] <String>]
      [[-Credential] <String>]
      [-Force]
      [<CommonParameters>]

Description

The Export-IscsiTargetServerConfiguration cmdlet exports a Microsoft iSCSI Target Server configuration. Use this cmdlet to archive an iSCSI Target Server configuration, or to create a file to import by using the Import-IscsiTargetServerConfiguration cmdlet.

The configuration information includes the following:

MigrationParentPath and ParentPath always have a value of null.

This cmdlet does not export Challenge Handshake Authentication Protocol (CHAP) secret keys, logical unit (LU) snapshot information, or transient state information such as current session information.

Examples

Example 1: Export configuration of a stand-alone server

PS C:\> Export-IscsiTargetServerConfiguration -Filename "D:\Server07Config.xml" -ComputerName "StandAloneIscsiServer07.Contoso.com" "

This command exports the iSCSI Target Server configuration of a stand-alone iSCSI Target Server to a specified file.

Example 2: Export configuration of a clustered server

PS C:\> Export-IscsiTargetServerConfiguration -Filename "D:\Server07Config.xml" -ComputerName "ClusteredIscsiInstance07.Contoso.com" -Force

This command exports the iSCSI Target Server configuration of a clustered iSCSI Target Server to a specified file. The command specifies the Force parameter. Therefore, it overwrites an existing file without prompting you.

Example 3: Export configuration of all clustered servers in a specified node

PS C:\> Export-IscsiTargetServerConfiguration -Filename "D:\Node22config.xml" -ComputerName "Node22-iSCSIServer.Contoso.com"

This command exports the iSCSI Target Server configuration of all clustered iSCSI Target Server instances hosted on the named cluster node to a specified file.

Required Parameters

-Filename

Specifies a file name. The cmdlet exports the configuration to the file that you specify. If a file already exists, the cmdlet overwrites the file after you confirm. If you specify the Force parameter, the cmdlet overwrites the file without confirmation.

Type:String
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-ComputerName

Specifies the computer name, or IP address, of the remote computer, if this cmdlet is run on a remote computer.

Specifies the cluster resource group network name, or cluster node name, if this cmdlet is run on a cluster configuration.

The cmdlet exports the configuration for the iSCSI Target Server instance that runs on the computer or cluster that you specify. If you do not specify a value for this parameter, the cmdlet uses the local computer.

Type:String
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Credential

Specifies the credentials when connecting to a remote computer.

Type:String
Position:2
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Force

Indicates that the cmdlet overwrites an existing export file without confirmation.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False