New-IscsiServerTarget

Creates a new iSCSI Target object with the specified name.

Syntax

New-IscsiServerTarget
   [-TargetName] <String>
   [-ClusterGroupName <String>]
   [-ComputerName <String>]
   [-Credential <PSCredential>]
   [-InitiatorIds <InitiatorId[]>]
   [<CommonParameters>]

Description

The New-IscsiServerTarget cmdlet creates an iSCSI Target object that has the specified name. After creating an iSCSI Target object, the target can be assigned to an iSCSI initiator, and a virtual disk can be associated with the target.

Examples

Example 1: Create a target on the local server

PS C:\> New-IscsiServerTarget -TargetName "T1"

This example creates a target named T1 on the local server.

Example 2: Create a target and assign initiators

PS C:\> New-IscsiServerTarget -TargetName "T1" -InitiatorId @("IPAddress:10.10.1.1","IPAddress:10.10.1.2")

This example creates a target with the name T1 and assigns it to two initiators, with IP addresses 10.10.1.1 and 10.10.1.2.

Example 3: Create a target on a cluster

PS C:\> New-IscsiServerTarget -TargetName "T1" -ComputerName "fscluster.contoso.com" -ClusterGroupName "Group1"

This example creates a target with the name T1 in the cluster group named Group1 on the cluster named fscluster.contoso.com.

Required Parameters

-TargetName

Specifies the name of the iSCSI target.

Type:String
Position:0
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

Optional Parameters

-ClusterGroupName

Specifies the name of the resource group or network in the resource group on which this cmdlet should be run.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ComputerName

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.

Type:String
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-Credential

Specifies the credentials when connecting to a remote computer.

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False
-InitiatorIds

Specifies the iSCSI initiator identifiers (IDs) to which the iSCSI target is assigned. The format of this parameter is IdType:Value. The acceptable values for this parameter are: DNSName, IPAddress, IPv6Address, IQN, or MACAddress.

Type:InitiatorId[]
Position:Named
Default value:None
Accept pipeline input:True (ByPropertyName)
Accept wildcard characters:False

Inputs

None

Outputs

Microsoft.Iscsi.Target.Commands.iSCSIServerTarget