Add-ClusteriSCSITargetServerRole
Creates a highly available iSCSI Target server.
Syntax
Add-ClusteriSCSITargetServerRole
-Storage <StringCollection>
[-StaticAddress <StringCollection>]
[-IgnoreNetwork <StringCollection>]
[[-Name] <String>]
[-Wait <Int32>]
[-InputObject <PSObject>]
[-Cluster <String>]
[<CommonParameters>] Description
The Add-ClusteriSCSITargetServerRole cmdlet creates a highly available iSCSI Target server.
Examples
Example 1: Create a clustered target server
PS C:\> Add-ClusteriSCSITargetServerRole -Storage "Cluster Disk 5"
Name OwnerNode State
---- --------- -----
CLiSCSITarget node1 OnlineThis example creates a clustered iSCSI Target server using Cluster Disk 5, and assigns a default name.
Example 2
PS C:\> Add-ClusteriSCSITargetServerRole -Storage "Cluster Disk 5" -Name MyiSCSITarget
Name OwnerNode State
---- --------- -----
MyiSCSITarget node1 OnlineThis example creates a clustered iSCSI Target server using Cluster Disk 5, and assigns the name MyiSCSITarget.
Example 3
PS C:\> Add-ClusteriSCSITargetServerRole -Storage "Cluster Disk 5" -Wait 0
Name OwnerNode State
---- --------- -----
CLiSCSITarget node1 PendingThis example creates a clustered iSCSI Target server using Cluster Disk 5, and assigns a default name. The cmdlet completes without waiting for all resources to come online.
Parameters
-Cluster
Specifies the name of the cluster on which to run this cmdlet.
If the input for this parameter is . or it is omitted, then the cmdlet runs on the local cluster.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IgnoreNetwork
Specifies one or more networks to ignore when running the cmdlet. Networks with DHCP enabled are always included, but other networks need a static address to be specified using the StaticAddress parameter or should be explicitly ignored with this IgnoreNetwork parameter.
| Type: | StringCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Specifies the cluster on which to create the highly available iSCSI Target server.
| Type: | PSObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Specifies the name of the highly available iSCSI Target server to create.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StaticAddress
Specifies one or more static addresses to use when running the cmdlet. Networks with DHCP enabled are always included, but other networks need a static address to be specified using the StaticAddress parameter or should be explicitly ignored with this IgnoreNetwork parameter.
| Type: | StringCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Storage
Specifies the cluster disk resource to be added to the created highly available iSCSI Target server.
| Type: | StringCollection |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Wait
Specifies the time in seconds to wait for the cmdlet.
If the Wait parameter is not specified, then the cmdlet waits for completion.
If -Wait 0 is specified, then the call is initiated and the cmdlet returns without waiting.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
Microsoft.FailoverClusters.PowerShell.Cluster
Outputs
Microsoft.FailoverClusters.PowerShell.ClusterGroup