Skip to content

Latest commit

 

History

History
151 lines (111 loc) · 3.99 KB

New-IscsiServerTarget.md

File metadata and controls

151 lines (111 loc) · 3.99 KB
description external help file Module Name ms.date online version schema title
Use this topic to help manage Windows and Windows Server technologies with Windows PowerShell.
Microsoft.Iscsi.Target.Commands.dll-Help.xml
IscsiTarget
12/20/2016
2.0.0
New-IscsiServerTarget

New-IscsiServerTarget

SYNOPSIS

Creates a new iSCSI Target object with the specified name.

SYNTAX

New-IscsiServerTarget [-TargetName] <String> [-InitiatorIds <InitiatorId[]>] [-ClusterGroupName <String>]
 [-ComputerName <String>] [-Credential <PSCredential>] [<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.

PARAMETERS

-ClusterGroupName

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

Type: String
Parameter Sets: (All)
Aliases: 

Required: False
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
Parameter Sets: (All)
Aliases: 

Required: False
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
Parameter Sets: (All)
Aliases: 

Required: False
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[]
Parameter Sets: (All)
Aliases: 

Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-TargetName

Specifies the name of the iSCSI target.

Type: String
Parameter Sets: (All)
Aliases: 

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

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

None

OUTPUTS

Microsoft.Iscsi.Target.Commands.iSCSIServerTarget

NOTES

RELATED LINKS

Get-IscsiServerTarget

Remove-IscsiServerTarget

Set-IscsiServerTarget