< Back
New-InStorHost
Post
NAME New-InStorHost
SYNOPSIS
Create a Host with name ,fcwwpn or iscsiname. A Host object will be returned if succeed else return null.
SYNTAX
New-InStorHost [-Conn] <InStorConnection> [-Name] <String> [-Fcwwpn] <String[]> [[-Opts] <String>]
[<CommonParameters>]
New-InStorHost [-Conn] <InStorConnection> [-Name] <String> [-Iscsiname] <String[]> [[-Opts] <String>]
[<CommonParameters>]
New-InStorHost [-Conn] <InStorConnection> [-Name] <String> [-Iscsiname] <String[]> [[-WinHostName] <String>]
[[-PsCredential] <PSCredential>] [[-Portals] <String[]>] [[-Opts] <String>] [<CommonParameters>]
DESCRIPTION
Create a Host with name ,fcwwpn or iscsiname. A Host object will be returned if succeed else return null.
PARAMETERS
-Conn <InStorConnection>
The Connection to MCS Storage, returned by cmdlet New-InStorConnection.
Required? true
Position? 0
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Name <String>
The name of host that will be Created.
Required? true
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Fcwwpn <String[]>
The host fc wwpn Array if the host connection type is FC.
Required? true
Position? 3
Default value
Accept pipeline input?
Accept wildcard characters? false
-Iscsiname <String[]>
The host iscsi name Array if the host connection type is iscsi.
Required? true
Position? 2
Default value
Accept pipeline input?
Accept wildcard characters? false
-WinHostName <String>
Windows host name that will setup iscsi connection.
Required? false
Position? 5
Default value
Accept pipeline input?
Accept wildcard characters? false
-PsCredential <PSCredential>
The windows host Credential information.
Required? false
Position? 5
Default value
Accept pipeline input?
Accept wildcard characters? false
-Portals <String[]>
The storage Portals that the windows host will connect.
Required? false
Position? 5
Default value
Accept pipeline input?
Accept wildcard characters? false
-Opts <String>
Optional parameter for special purpose.
Required? false
Position? 5
Default value
Accept pipeline input?
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
System.Management.Automation.PSObject
returns a PSObject Object.
-------------------------- EXAMPLE 1 --------------------------
New-InStorHost -Conn $conn -Name "host_fc" -Fcwwpn @("210100E08B251DD4","210100F08C262DD8")
Create a Host named "host_fc" with fcwwpn.
id name status
-- ---- ------
1 host_fc online
RELATED LINKS
SYNOPSIS
Create a Host with name ,fcwwpn or iscsiname. A Host object will be returned if succeed else return null.
SYNTAX
New-InStorHost [-Conn] <InStorConnection> [-Name] <String> [-Fcwwpn] <String[]> [[-Opts] <String>]
[<CommonParameters>]
New-InStorHost [-Conn] <InStorConnection> [-Name] <String> [-Iscsiname] <String[]> [[-Opts] <String>]
[<CommonParameters>]
New-InStorHost [-Conn] <InStorConnection> [-Name] <String> [-Iscsiname] <String[]> [[-WinHostName] <String>]
[[-PsCredential] <PSCredential>] [[-Portals] <String[]>] [[-Opts] <String>] [<CommonParameters>]
DESCRIPTION
Create a Host with name ,fcwwpn or iscsiname. A Host object will be returned if succeed else return null.
PARAMETERS
-Conn <InStorConnection>
The Connection to MCS Storage, returned by cmdlet New-InStorConnection.
Required? true
Position? 0
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Name <String>
The name of host that will be Created.
Required? true
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Fcwwpn <String[]>
The host fc wwpn Array if the host connection type is FC.
Required? true
Position? 3
Default value
Accept pipeline input?
Accept wildcard characters? false
-Iscsiname <String[]>
The host iscsi name Array if the host connection type is iscsi.
Required? true
Position? 2
Default value
Accept pipeline input?
Accept wildcard characters? false
-WinHostName <String>
Windows host name that will setup iscsi connection.
Required? false
Position? 5
Default value
Accept pipeline input?
Accept wildcard characters? false
-PsCredential <PSCredential>
The windows host Credential information.
Required? false
Position? 5
Default value
Accept pipeline input?
Accept wildcard characters? false
-Portals <String[]>
The storage Portals that the windows host will connect.
Required? false
Position? 5
Default value
Accept pipeline input?
Accept wildcard characters? false
-Opts <String>
Optional parameter for special purpose.
Required? false
Position? 5
Default value
Accept pipeline input?
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
System.Management.Automation.PSObject
returns a PSObject Object.
-------------------------- EXAMPLE 1 --------------------------
New-InStorHost -Conn $conn -Name "host_fc" -Fcwwpn @("210100E08B251DD4","210100F08C262DD8")
Create a Host named "host_fc" with fcwwpn.
id name status
-- ---- ------
1 host_fc online
RELATED LINKS