New-Host
SYNOPSIS
Creates a host on the PowerStore cluster.
SYNTAX
ByFC (Default)
New-Host [-Cluster] <Cluster> [-Name] <String> -OsType {Windows | Linux | ESXi | AIX | HP-UX | Solaris} -FcInitiators <String[]> [-Description <String>]
[-Confirm] [-WhatIf] [<CommonParameters>]
ByISCSI
New-Host [-Cluster] <Cluster> [-Name] <String> -OsType {Windows | Linux | ESXi | AIX | HP-UX | Solaris} -IscsiInitiators <String[]> [-Description <String>]
[-ChapSingleUserName <String>] [-ChapSinglePassword <String>] [-ChapMutualUserName <String>] [-ChapMutualPassword <String>] [-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
Creates a FC/iSCSI host on the PowerStore cluster.
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.
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
-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: True (ByPropertyName, ByValue)
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 (ByPropertyName, 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: True (ByPropertyName, ByValue)
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
-ChapSingleUserName
CHAP single user name.
Type: String
Parameter Sets: ByISCSI
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-ChapSinglePassword
CHAP single password.
Type: String
Parameter Sets: ByISCSI
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
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: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-ChapMutualPassword
CHAP mutual password.
Type: String
Parameter Sets: ByISCSI
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
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: None
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: None
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.