Set-Host

SYNOPSIS

Modifies host.

SYNTAX

Rename

Set-Host [-Unisphere] <UnisphereServer> [-ArrayId] <String> [-Id] <String> -NewId <String> [-Confirm] [-WhatIf] [<CommonParameters>]

AddInitiator

Set-Host [-Unisphere] <UnisphereServer> [-ArrayId] <String> [-Id] <String> -AddInitiator <String[]> [-Confirm] [-WhatIf] [<CommonParameters>]

RemoveInitiator

Set-Host [-Unisphere] <UnisphereServer> [-ArrayId] <String> [-Id] <String> -RemoveInitiator <String[]> [-Confirm] [-Force] [-WhatIf] [<CommonParameters>]

SetFlags

Set-Host [-Unisphere] <UnisphereServer> [-ArrayId] <String> [-Id] <String> [-ConsistentLUN <Boolean>] [-VolumeSetAddressing <Boolean>] [-DisableQResetOnUa <Boolean>] [-EnvironSet <Boolean>] [-AvoidResetBroadcast <Boolean>] 
[-OpenVms <Boolean>] [-Scsi3 <Boolean>] [-Spc2ProtocolVersion <Boolean>] [-ScsiSupport1 <Boolean>] [-Confirm] [-Force] [-WhatIf] [<CommonParameters>]

DESCRIPTION

Modifies host ID, adds or removes initiators and modifies host flags. Host flags can be set to true, false or null. To override and enable a flag, set its value to True. To override and disable a flag, set its value to False. To set override value of a flag to false, set the flag value to Null. When no parameter is provided, current flag is retained. ConsistentLUN flag takes the value differently than other host flags. If ConsistentLUN is set to null, current flag value is retained. To enable the flag, set its value to True. To disable the flag, set its value to False.

EXAMPLES

Example 1

PS C:\> Set-Host -Unisphere $unisphere -ArrayId 000123456789 -Id host1 -NewId host2

Where $unisphere is a Unisphere server instance. Changes the host ID from host1 to host2.

Example 2

PS C:\> Set-Host -Unisphere $unisphere -ArrayId 000123456789 -Id host2 -AddInitiator initiator1,initiator2

Where $unisphere is a Unisphere server instance. Adds initiator1 and initiator2 to host2.

Example 3

PS C:\> Set-Host -Unisphere $unisphere -ArrayId 000123456789 -Id host2 -RemoveInitiator initiator2

Where $unisphere is a Unisphere server instance. Removes initiator2 from host2.

Example 4

PS C:\> Set-Host -Unisphere $unisphere -ArrayId 000123456789 -Id host1 -ConsistentLUN $False -EnvironSet $True -AvoidResetBroadcast $Null

Where $unisphere is a Unisphere server instance. Changes the host flags and sets ConsistentLun to False, enables EnvironSet flag and disables override flag for AvoidResetBroadcast flag and disables AvoidResetBroadcast flag.

PARAMETERS

-Unisphere

The Unisphere server object.

Type: UnisphereServer
Parameter Sets: (All)
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-ArrayId

The PowerMax array ID.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-Id

Host ID.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 2
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-NewId

New host ID.

Type: String
Parameter Sets: Rename
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AddInitiator

Initiator IDs to add to host.

Type: String[]
Parameter Sets: AddInitiator
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RemoveInitiator

Initiator IDs to remove from host.

Type: String[]
Parameter Sets: RemoveInitiator
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ConsistentLUN

Consistent LUN host flag.

Type: Boolean
Parameter Sets: SetFlags
Aliases:

Required: False
Position: Named
Default value: True
Accept pipeline input: False
Accept wildcard characters: False

-VolumeSetAddressing

Volume Set Addressing host flag.

Type: Boolean
Parameter Sets: SetFlags
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisableQResetOnUa

Disable Q Reset on UA host flag.

Type: Boolean
Parameter Sets: SetFlags
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnvironSet

Environ Set host flag.

Type: Boolean
Parameter Sets: SetFlags
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AvoidResetBroadcast

Avoid Reset Broadcast host flag.

Type: Boolean
Parameter Sets: SetFlags
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-OpenVms

Open VMs host flag.

Type: Boolean
Parameter Sets: SetFlags
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Scsi3

SCSI3 host flag.

Type: Boolean
Parameter Sets: SetFlags
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Spc2ProtocolVersion

SPC2 Protocol Version host flag.

Type: Boolean
Parameter Sets: SetFlags
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ScsiSupport1

SCSI Support 1 host flag.

Type: Boolean
Parameter Sets: SetFlags
Aliases:

Required: False
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: True
Accept pipeline input: False
Accept wildcard characters: False

-Force

Skips confirmation before modifying the host.

Type: SwitchParameter
Parameter Sets: RemoveInitiator, SetFlags
Aliases:

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.

INPUTS

Dell.PowerMax.Management.Model.UnisphereServer

System.String

OUTPUTS

Dell.PowerMax.Management.Model.Host

NOTES

ConsistentLUN flag takes the value differently than other host flags. If ConsistentLUN is set to null, current flag value is retained. To enable the flag, set its value to true. To disable the flag, set its value to false.