NAME

Set-DcsiSCSIInitiatorSecret

SYNOPSIS

Sets a secret for the Microsoft iSCSI Initiator port on a server.

SYNTAX

Set-DcsiSCSIInitiatorSecret   [ -Server <String> ]   -Port <Object>   -Secret <String>   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Sets a secret for the Microsoft iSCSI Initiator port on a server. The secret is used for mutual authentication.

PARAMETERS

-Server<String>
Computer name or ID of the server. The computer name must be unique or the name must be fully qualified.

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-Port<Object>
The ScsiPortData object, name, ID, or address of the Microsoft iSCSI Initiator port. In order to uniquely identify the port by name, the server must be specified.

Required: true
Position: named
Default value:
Accept pipeline input: true (ByValue)
Accept wildcard characters: false

-Secret<String>
Use this parameter to set the secret for the Microsoft iSCSI Initiator port. The secret is 12-16 characters. Use caution when entering the secret, it will appear as typed on the display.

Required: true
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-Connection<String>
Alias of the connection to the server group. If not specified, the default connection is used.

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-PipelineVariable<String>

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

INPUTS

ScsiPortData : Object that identifies the port (Microsoft iSCSI Initiator).

OUTPUTS

ScsiPortData : Object that identifies the port (Microsoft iSCSI Initiator).

NOTES

Also see Add-DcsAccessToken, Connect-DcsiSCSITarget, Set-DcsInitiatorNodeName.

EXAMPLES


-------------- Example 1 Sets the secret by identifying the port by name (caption) --------------
Set-DcsiSCSIInitiatorSecret -Server SSV1 -Port "Microsoft iSCSI Initiator" -Secret 111111111111
			

Sets the secret for the port named "Microsoft iSCSI Initiator" on the server "SSV1" to be "11111111111".

InitiatorPortals:{fe80::ac9f:4abc:8e7:447a, fe80::2de4:e3b4:87d0:b299, fe80::f13e:c21d:f0b8:c2e, fe80::d86e:28b1:6c8e:ee36...}
iSnsServer:{}
TargetPortals:{DataCore.Executive.iScsiTargetPortalData}
PresenceStatus:Present
PhysicalName:MSFT-05-1991
ServerPortProperties:DataCore.Executive.ServerPortPropertiesData
RoleCapability:Backend, Mirror
PortName:SSV1MSiSCSIInitiator
Alias:Microsoft iSCSI Initiator
Description:
PortType:iSCSI
PortMode:Initiator
HostId:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4
Connected:True
Id:84972D6B-7E71-4616-BDA1-57ECEAF3FFC4:MSFT-05-1991
Caption:Microsoft iSCSI Initiator
ExtendedCaption:Microsoft iSCSI Initiator on SSV1
Internal:False