Set-HostGroup

SYNOPSIS

Modifies host group.

SYNTAX

Rename

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

AddHost

Set-HostGroup [-Unisphere] <UnisphereServer> [-ArrayId] <String> [-Id] <String> -AddHost <String[]> [-Confirm] [-WhatIf] [<CommonParameters>]

RemoveHost

Set-HostGroup [-Unisphere] <UnisphereServer> [-ArrayId] <String> [-Id] <String> -RemoveHost <String[]> [-Confirm] [-Force] [-WhatIf] [<CommonParameters>]

SetFlags

Set-HostGroup [-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 group ID, adds or removes hosts 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-HostGroup -Unisphere $unisphere -ArrayId 000123456789 -Id hostgroup1 -NewId hostgroup2

Where $unisphere is a Unisphere server instance. Changes the host group ID from hostgroup1 to hostgroup2.

Example 2

PS C:\> Set-HostGroup -Unisphere $unisphere -ArrayId 000123456789 -Id hostgroup2 -AddHost host1,host2

Where $unisphere is a Unisphere server instance. Adds host1 and host2 to hostgroup2.

Example 3

PS C:\> Set-HostGroup -Unisphere $unisphere -ArrayId 000123456789 -Id hostgroup2 -RemoveHost host2

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

Example 4

PS C:\> Set-HostGroup -Unisphere $unisphere -ArrayId 000123456789 -Id hostgroup2 -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 group 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 group ID.

Type: String
Parameter Sets: Rename
Aliases:

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

-AddHost

Host IDs to add to host group.

Type: String[]
Parameter Sets: AddHost
Aliases:

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

-RemoveHost

Host IDs to remove from host group.

Type: String[]
Parameter Sets: RemoveHost
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 group.

Type: SwitchParameter
Parameter Sets: RemoveHost, 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.HostGroup

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.