Share via


NewHost method of the WT_Host class

Creates a new iSCSI target by using the specified target name.

Syntax

WT_Host NewHost(
  [in] string HostName,
  [in] string ResourceGroup
);

Parameters

HostName [in]

A name that uniquely identifies the iSCSI target entry within the iSCSI target server. This is not the IQN (iSCSI Qualified Name), but a Microsoft iSCSI Target Server-specific identifier. It is recommended that the initiator’s NetBIOS name be used as the host name for easier identification.

ResourceGroup [in]

Optional name of the cluster group that the iSCSI target resource belongs to. If the Microsoft iSCSI Target Server Service is not running on a Microsoft Failover Cluster, this parameter is an empty string.

Remarks

If the Microsoft iSCSI Target Server service is running on a Microsoft Failover Cluster, a cluster resource is created to represent the new iSCSI target. If ResourceGroup is specified, the cluster resource will be created in the ResourceGroup. If no ResourceGroup is specified, the cluster resource will be created in the first resource group that is not considered a core resource group. It is highly recommended that the ResourceGroup parameter be specified when the iSCSI target service is running in a Microsoft cluster environment.

Requirements

Minimum supported client
None supported
Minimum supported server
Windows Server 2012
Namespace
Root\Wmi
MOF
WmiWtProvider.mof
DLL
WtWmiProv.dll

See also

WT_Host