Export-IscsiTargetServerConfiguration
Export-IscsiTargetServerConfiguration
Exports an iSCSI Target Server configuration.
Sintaxis
Parameter Set: Default
Export-IscsiTargetServerConfiguration [-Filename] <String> [[-ComputerName] <String> ] [[-Credential] <String> ] [-Force] [ <CommonParameters>]
Descripción detallada
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:
-- If the cmdlet exports the configuration from a clustered iSCSI Target Server instance, the resource group name.
-- For an import of the configuration into an iSCSI Target Server clustered instance, the name of the resource group into which to import the configuration. This resource group name is the same as the iSCSI virtual disk attribute named MigrationResourceGroup.
-- The following attributes for each iSCSI target that iSCSI Target Server hosts: Enabled (target state), HostName, TargetIQN, Description, ResourceGroup, MigrationResourceGroup, EnforceIdleTimeoutDetection, FirstBurstLength, MaxBurstLength, MaxRecvDataSegmentLength, NumRecvBuffers, EnableCHAP, CHAPUserName, EnableReverseCHAP, ReverseCHAPUserName, InitiatorIDs, and LunMappings.
-- The following attributes for each iSCSI virtual disk that iSCSI Target Server recognizes: DiskId, Type, Enabled, DevicePath, ParentPath, Description, SnapshotStorageSize, MigrationDevicePath, MigrationParentPath, and MigrationResourceGroup.
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.
Parámetros
-ComputerName<String>
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.
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
2 |
Valor predeterminado |
localhost |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Credential<String>
Specifies the credentials when connecting to a remote computer.
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
3 |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Filename<String>
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.
Alias |
ninguno |
¿Requerido? |
true |
¿Posición? |
1 |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Force
Indicates that the cmdlet overwrites an existing export file without confirmation.
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los siguientes parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Entradas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet.
Salidas
El tipo de resultado es el tipo de objetos que emite el cmdlet.
Ejemplos
Example 1: Export configuration of a standalone server
This command exports the iSCSI Target Server configuration of a standalone iSCSI Target Server to a specified file.
PS C:\> Export-IscsiTargetServerConfiguration -Filename "D:\Server07Config.xml" –ComputerName "StandAloneIscsiServer07.Contoso.com" "
Example 2: Export configuration of a clustered server
This command exports the iSCSI Target Server configuration of a clustered iSCSI Target Server to a specified file. The command includes the Force, and, therefore, it overwrites an existing file without prompting you.
PS C:\> Export-IscsiTargetServerConfiguration -Filename "D:\Server07Config.xml" –ComputerName "ClusteredIscsiInstance07.Contoso.com" –Force
Example 3: Export configuration of all clustered servers in a specified node
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.
PS C:\> Export-IscsiTargetServerConfiguration -Filename "D:\Node22config.xml" –ComputerName "Node22-iSCSIServer.Contoso.com"