en-US/about_iSCSIInitiator.help.txt
.NAME
iSCSIInitiator # Description This resource is used to add or remove an iSCSI Target Portal and connect it to an iSCSI Target. .PARAMETER NodeAddress Key - String Represents the IQN of the discovered target. .PARAMETER TargetPortalAddress Required - String Specifies the IP address or DNS name of the target portal. .PARAMETER Ensure Write - String Allowed values: Present, Absent Ensures that Target is Absent or Present. .PARAMETER InitiatorPortalAddress Write - String Specifies the IP address associated with the target portal. .PARAMETER TargetPortalPortNumber Write - Uint16 Specifies the TCP/IP port number for the target portal. .PARAMETER InitiatorInstanceName Write - String The name of the initiator instance that the iSCSI initiator service uses to send SendTargets requests to the target portal. .PARAMETER AuthenticationType Write - String Allowed values: None, OneWayCHAP, MutualCHAP Specifies the type of authentication to use when logging into the target. .PARAMETER ChapUsername Write - String Specifies the user name to use when establishing a connection authenticated by using Mutual CHAP. .PARAMETER ChapSecret Write - String Specifies the CHAP secret to use when establishing a connection authenticated by using CHAP. .PARAMETER IsDataDigest Write - Boolean Enables data digest when the initiator logs into the target portal. .PARAMETER IsHeaderDigest Write - Boolean Enables header digest when the initiator logs into the target portal. By not specifying this parameter, the digest setting is determined by the initiator kernel mode driver. .PARAMETER IsMultipathEnabled Write - Boolean Indicates that the initiator has enabled Multipath I/O (MPIO) and it will be used when logging into the target portal. .PARAMETER IsPersistent Write - Boolean Specifies that the session is to be automatically connected after each restart. .PARAMETER ReportToPnP Write - Boolean Specifies that the operation is reported to PNP. .PARAMETER iSNSServer Write - String Specifies the name of an iSNS Server to register this Initiator with. .PARAMETER IsConnected Read - Boolean Is the target connected to the server. .PARAMETER ConnectionIdentifier Read - String This is the current connection identifier for this target connection. .PARAMETER SessionIdentifier Read - String This is the current session identifier for this target session. .PARAMETER IsDiscovered Read - Boolean Is the target discovered in this session. .PARAMETER InitiatorNodeAddress Read - String The Initiator Node address assigned to this session. .PARAMETER TargetNodeAddress Read - String The Target Node address assigned to this session. .EXAMPLE This example starts the MSiSCSI service on a cluster node and then configures an iSCSI Target Portal and then connects to the iSCSI Target. Configuration Example { param ( [Parameter()] [System.String[]] $NodeName = 'localhost' ) Import-DscResource -Module iSCSIDSc Node $NodeName { Service iSCSIService { Name = 'MSiSCSI' StartupType = 'Automatic' State = 'Running' } iSCSIInitiator iSCSIInitiator { Ensure = 'Present' NodeAddress = 'iqn.1991-05.com.microsoft:fileserver01-cluster-target' TargetPortalAddress = '192.168.128.10' InitiatorPortalAddress = '192.168.128.20' IsPersistent = $true iSNSServer = 'isns.contoso.com' DependsOn = "[Service]iSCSIService" } # End of iSCSIInitiator Resource } # End of Node } # End of Configuration |