Get-IscsiServerTarget

Obtains iSCSI targets and their associated properties.

Syntax

Get-IscsiServerTarget
   [-ClusterGroupName <String>]
   [[-TargetName] <String>]
   [-ComputerName <String>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-IscsiServerTarget
   [-ClusterGroupName <String>]
   [-Path <String>]
   [-ComputerName <String>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-IscsiServerTarget
   [-ClusterGroupName <String>]
   [-InitiatorId <InitiatorId>]
   [-ComputerName <String>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Description

The Get-IscsiServerTarget cmdlet obtains iSCSI targets and their associated properties from the local server or specified computer.

Examples

Example 1: Get targets on the local server

PS C:\> Get-IscsiServerTarget

This example gets the iSCSI targets on the local server.

Example 2: Get targets on a remote server

PS C:\> Get-IscsiServerTarget -ComputerName "fs1.contoso.com"

This example gets all of the iSCSI targets on the remote server named fs1.contoso.com.

Example 3: Get targets on a cluster

PS C:\> Get-IscsiServerTarget -ComputerName "fscluster.contoso.com" -ClusterGroupName "target1group"

This example gets all of the iSCSI targets in the resource group named target1group on the cluster named fscluster.contoso.com.

Example 4: Get a target by using a path

PS C:\> Get-IscsiServerTarget -Path "E:\temp\test.vhdx"

This example gets the iSCSI target associated with the VHD with the path E:\temp\test.vhdx.

Example 5: Get targets assigned to an initiator

PS C:\> Get-IscsiServerTarget -InitiatorId "DNSName:TargetSvr.Contoso.com"

This example gets all of the iSCSI targets that have been assigned to the initiator with type DNSName, and value TargetSvr.contoso.com.

Parameters

-ClusterGroupName

Specifies the name of the resource group or network in the resource group on which this cmdlet runs.

Type:String
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Credential

Specifies the credentials when connecting to a remote computer.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-InitiatorId

Specifies the iSCSI initiator identifiers (IDs) to which the iSCSI target is assigned. Use this parameter to filter out the iSCSI Server Target object which can be accessed by the given iSCSI initiator. The format of this parameter is IdType:Value. The acceptable values for this parameter are: DNSName, IPAddress, IPv6Address, IQN, and MACAddress.

Type:InitiatorId
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Path

Specifies the path of the virtual hard disk (VHD) file that is associated with the iSCSI virtual disk. Use this parameter to filter the iSCSI Target object that is associated with the virtual disks.

Type:String
Aliases:DevicePath
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TargetName

Specifies the name of the iSCSI target. Use this parameter to filter out the iSCSI Target object.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Inputs

Microsoft.Iscsi.Target.Commands.IscsiServerTarget

Outputs

Microsoft.Iscsi.Target.Commands.IscsiServerTarget