New-Host
SYNOPSIS
Creates a host on the PowerStore cluster.
SYNTAX
ByFC (Default)
New-Host [-Cluster] <Cluster> [-Name] <String> [-Description <String>] -OsType {Windows | Linux | ESXi | AIX | HP-UX | Solaris} -FcInitiators <String[]>
-HostConnectivity {LocalOnly | MetroOptimizeBoth | MetroOptimizeLocal | MetroOptimizeRemote} [-WhatIf] [-Confirm] [<CommonParameters>]
ByISCSI
New-Host [-Cluster] <Cluster> [-Name] <String> [-Description <String>] -OsType {Windows | Linux | ESXi | AIX | HP-UX | Solaris} -IscsiInitiators <String[]>
-HostConnectivity {LocalOnly | MetroOptimizeBoth | MetroOptimizeLocal | MetroOptimizeRemote} [-ChapSingleUserName <String>] [-ChapSinglePassword <String>]
[-ChapSingleCredential <PSCredential>] [-ChapMutualUserName <String>] [-ChapMutualPassword <String>] [-ChapMutualCredential <PSCredential>] [-WhatIf]
[-Confirm] [<CommonParameters>]
ByNVMe
New-Host [-Cluster] <Cluster> [-Name] <String> [-Description <String>] -OsType {Windows | Linux | ESXi | AIX | HP-UX | Solaris} -HostConnectivity {LocalOnly
|MetroOptimizeBoth | MetroOptimizeLocal | MetroOptimizeRemote} -NvmeInitiators <String[]> [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Creates a host entry on the PowerStore cluster. Supported protocols are Fibre Channel, iSCSI, and NVMe.
EXAMPLES
Example 1
New-Host -Cluster $cluster -Name name1 -Description "Example FC host" -OsType Windows -FcInitiators 11:22:33:44:11:22:33:44
Where $cluster is a PowerStore cluster instance. Creates a fiber channel (FC) host with name name1, OS type Windows and initiator 11:22:33:44:11:22:33:44.
Example 2
New-Host -Cluster $cluster -Name name1 -Description "Example iSCSI host" -OsType Linux -IscsiInitiators iqn.2020-01.com.example:linux-1,iqn.2020-01.com.example:linux-2
Where $cluster is a PowerStore cluster instance. Creates an iSCSI host with name name1, OS type Linux and initiators iqn.2020-01.com.example:linux-1,iqn.2020-01.com.example:linux-2.
Example 3
New-Host -Cluster $cluster -Name name1 -Description "Example iSCSI host" -OsType Linux -IscsiInitiators iqn.2020-01.com.example:linux-1,iqn.2020-01.com.example:linux-2 -ChapSingleUserName user1 -ChapSinglePassword pwd1
Where $cluster is a PowerStore cluster instance. Creates an iSCSI host with name name1, OS type Linux and initiators iqn.2020-01.com.example:linux-1,iqn.2020-01.com.example:linux-2 using CHAP single authentication.
Example 4
New-Host -Cluster $cluster -Name name1 -Description "Example iSCSI host" -OsType Windows -IscsiInitiators iqn.2020-01.com.example:windows-1 -ChapSingleUserName user1 -ChapSinglePassword pwd1 -ChapMutualUserName user2 -ChapMutualPassword pwd2
Where $cluster is a PowerStore cluster instance. Creates an iSCSI host with name name1, OS type Windows and initiators iqn.2020-01.com.example:windows-1 using CHAP mutual authentication.
Example 5
New-Host -Cluster $cluster -Name name1 -Description "Example NVMe host" -OsType Linux -NvmeInitiators nqn.2014-08.org.nvmexpress:uuid:9710438c-4333-4ba0-82b4-c49bee51c354,nqn.2014-08.org.nvmexpress:uuid:0ea47404-e711-4650-a7df-da1666902df8
Where $cluster is a PowerStore cluster instance. Creates an NVMe host with name name1, OS type Linux and initiators nqn.2014-08.org.nvmexpress:uuid:9710438c-4333-4ba0-82b4-c49bee51c354,nqn.2014-08.org.nvmexpress:uuid:0ea47404-e711-4650-a7df-da1666902df8.
PARAMETERS
-Cluster
PowerStore cluster instance.
Type: Cluster
Parameter Sets: (All)
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Host name.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Description
Host description.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-OsType
OS type.
Type: String
Parameter Sets: (All)
Aliases:
Accepted values: Windows, Linux, ESXi, AIX, HP-UX, Solaris
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-HostConnectivity
Connectivity type for hosts and host groups.
- LocalOnly - Local connectivity to this array.
- MetroOptimizeBoth - Optimized status for both this cluster and the remote cluster
- MetroOptimizeLocal - Optimized status for this cluster, and non-optimized status for the remote cluster
- MetroOptimizeRemote - Non-optimized status for this cluster, and optimized status for the remote cluster
Type: String
Parameter Sets: (All)
Aliases:
Accepted values: LocalOnly, MetroOptimizeBoth, MetroOptimizeLocal, MetroOptimizeRemote
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-FcInitiators
List of FC initiators.
Type: String[]
Parameter Sets: ByFC
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-IscsiInitiators
List of iSCSI initiatiors.
Type: String[]
Parameter Sets: ByISCSI
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ChapSingleUserName
CHAP single user name.
Type: String
Parameter Sets: ByISCSI
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ChapSinglePassword
CHAP single password.
Type: String
Parameter Sets: ByISCSI
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ChapSingleCredential
PSCredential instance used as CHAP single user and password.
Type: PSCredential
Parameter Sets: ByISCSI
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ChapMutualUserName
CHAP mutual user name.
Type: String
Parameter Sets: ByISCSI
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ChapMutualPassword
CHAP mutual password.
Type: String
Parameter Sets: ByISCSI
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ChapMutualCredential
PSCredential instance used as CHAP mutual user and password.
Type: PSCredential
Parameter Sets: ByISCSI
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NvmeInitiators
List of NVMe initiators.
Type: String[]
Parameter Sets: ByNVMe
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.