Add-ClusteriSCSITargetServerRole
Creates a highly available iSCSI Target server.
Syntax
Add-ClusteriSCSITargetServerRole
[[-Name] <String>]
[-Cluster <String>]
[-IgnoreNetwork <StringCollection>]
[-InputObject <PSObject>]
[-StaticAddress <StringCollection>]
[-Wait <Int32>]
-Storage <StringCollection>
Description
The Add-ClusteriSCSITargetServerRole cmdlet creates a highly available iSCSI Target server.
Examples
EXAMPLE 1
PS C:\>Add-ClusteriSCSITargetServerRole -Storage "Cluster Disk 5"
Name OwnerNode State
---- --------- -----
CLiSCSITarget node1 Online
This 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 Online
This 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 Pending
This 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: | 1 |
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
Related Links
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for