Skip to content

Remove-VmsFailoverGroup

SYNOPSIS

Removes an existing failover group from the current Milestone XProtect VMS site.

SYNTAX

Remove-VmsFailoverGroup [-FailoverGroup] <FailoverGroup> [-Force] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

The Remove-VmsFailoverGroup cmdlet removes an existing failover group, which can each contain one or more failover recording servers.

REQUIREMENTS

  • Requires VMS connection and will attempt to connect automatically
  • Requires VMS version 21.2
  • Requires VMS feature "RecordingServerFailover"

EXAMPLES

Example 1

Connect-Vms -ShowDialog -AcceptEula

Get-VmsFailoverGroup | Select-Object -First 1 | Remove-VmsFailoverGroup -WhatIf

Prompts user to login to a Milestone VMS, then attempts to remove the first failover group returned by Get-VmsFailoverGroup but does not actually remove the failover group thanks to the -WhatIf switch.

PARAMETERS

-FailoverGroup

Specifies a FailoverGroup object returned by the Get-VmsFailoverGroup cmdlet.

Type: FailoverGroup
Parameter Sets: (All)
Aliases:

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

-Force

Specifies that any members of the failover group should be removed from the group and then the group should be deleted.

Type: SwitchParameter
Parameter Sets: (All)
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: 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

VideoOS.Platform.ConfigurationItems.FailoverGroup

OUTPUTS

None

NOTES