Register-IscsiSession

Register-IscsiSession

Registers an active iSCSI session to be persistent using the session identifier as input.

Sintaxis

Parameter Set: BySessionIdentifier
Register-IscsiSession -SessionIdentifier <String[]> [-AsJob] [-ChapSecret <String> ] [-ChapUsername <String> ] [-CimSession <CimSession[]> ] [-IsMultipathEnabled <Boolean> ] [-PassThru] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: InputObject (cdxml)
Register-IscsiSession -InputObject <CimInstance[]> [-AsJob] [-ChapSecret <String> ] [-ChapUsername <String> ] [-CimSession <CimSession[]> ] [-IsMultipathEnabled <Boolean> ] [-PassThru] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Descripción detallada

The Register-IscsiSession cmdlet registers an existing iSCSI session to make it persistent. Once an iSCSI session is registered, it will automatically attempt to reconnect on reboot.

Note: Registering a connection multiple times will automatically re-establish multiple sessions for use with Multipath I/O (MPIO).

Parámetros

-AsJob

-ChapSecret<String>

Specifies the CHAP secret to use when establishing a connection authenticated by using CHAP.

-ChapUsername<String>

Specifies the user name to use when establishing a connection authenticated by using Mutual CHAP.

-CimSession<CimSession[]>

Ejecuta el cmdlet en una sesión remota o en un equipo remoto. Escriba un nombre de equipo o un objeto de sesión, como la salida de un cmdlet New-CimSession o Get-CimSession. El valor predeterminado es la sesión actual en el equipo local.

-InputObject<CimInstance[]>

Accepts an object from the pipeline as input.

-IsMultipathEnabled<Boolean>

Indicates that the initiator has enabled Multipath I/O (MPIO) and it will be used when logging into the target portal.

-PassThru

Sends items from the interactive window down the pipeline as input to other cmdlets. By default, this cmdlet does not generate any output.
To send items from the interactive window down the pipeline, click to select the items and then click OK. Shift-click and Ctrl-click are supported.

-SessionIdentifier<String[]>

Specifies the session identifier.

-ThrottleLimit<Int32>

Especifica el número máximo de operaciones simultáneas que se pueden establecer para ejecutar el cmdlet. Si se omite este parámetro o es especifica un valor de 0, Windows PowerShell ® calcula un límite óptimo para el cmdlet en función del número de cmdlets de CIM que se estén ejecutando en el equipo. El límite solo se aplica al cmdlet actual, no a la sesión ni al equipo.

<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.

• None

Salidas

El tipo de resultado es el tipo de objetos que emite el cmdlet.

• Microsoft.Management.Infrastructure.Ciminstance#MSFT_IscsiSession

  El objeto Microsoft.Management.Infrastructure.CimInstance es una clase contenedora que muestra objetos de Instrumental de administración de Windows (WMI). La ruta de acceso después del signo de número (#) proporciona el espacio de nombres y el nombre de clase del objeto WMI subyacente.

Ejemplos

EXAMPLE 1

This example registers the iSCSI session with the session ID fffffa800d008430-4000013700000001 to be persistent across reboots.

PS C:\> Register-IscsiSession -SessionIdentifier fffffa800d008430-4000013700000001

Temas relacionados

N:MPIO

N:Storage

iSCSI on TechNet

Storage on TechNet