NAME

Set-DcsInitiatorNodeName

SYNOPSIS

Changes the name of the Microsoft iSCSI Initiator port on a server.

SYNTAX

Set-DcsInitiatorNodeName   -Port <Object>   -Name <String>   [ -Server <String> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Changes the name of the Microsoft iSCSI Initiator port on a server. The name is also known as the IQN.

PARAMETERS

-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: 1

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-Name<String>

The new name (IQN) for the Microsoft iSCSI Initiator port. All letters must be entered in lowercase.

Required: true

Position: 2

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-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: 3

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

OUTPUTS

ScsiPortData : Object that identifies and describes the initiator port.

NOTES

Also see Set-DcsiSCSIInitiatorSecret.

EXAMPLES

$port = Get-DcsPort -Machine SSV3 | ? { $_.Portmode -eq "initiator" }
Set-DcsInitiatorNodeName -Port $port -Name ssv3initiator