| description | external help file | Module Name | ms.date | online version | schema | title |
|---|---|---|---|---|---|---|
Use this topic to help manage Windows and Windows Server technologies with Windows PowerShell. |
Microsoft.FailoverClusters.PowerShell.dll-Help.xml |
FailoverClusters |
11/22/2022 |
2.0.0 |
Remove-Cluster |
Destroys an existing failover cluster.
Remove-Cluster [[-Cluster] <String>] [-CleanupAD] [-Force] [-InputObject <PSObject>] [-WhatIf]
[-Confirm] [<CommonParameters>]
The Remove-Cluster cmdlet destroys an existing failover cluster. The affected servers will no
longer function together as a cluster.
This cmdlet deletes all copies of the cluster configuration database on all cluster nodes.
Note: This cmdlet cannot be run remotely without Credential Security Service Provider (CredSSP) authentication on the server computer.
Remove-ClusterThis example prompts the user for confirmation, then destroys the local failover cluster and removes cluster configuration information from the cluster nodes.
Remove-Cluster -ForceThis example destroys the local failover cluster and removes cluster configuration information from the cluster nodes. The cmdlet doesn't prompt for confirmation.
Get-Cluster -Name Cluster1 | Remove-Cluster -Force -CleanupADThis example destroys the cluster named Cluster1, removes cluster configuration information from
the cluster nodes, and deletes the cluster objects in Active Directory. The cmdlet doesn't prompt
for confirmation.
Specifies that when the cluster is destroyed, the objects in Active Directory that are associated with the cluster are removed.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseSpecifies the name of the cluster on which to run this cmdlet. If the input for this parameter is
. or it is omitted, then the cmdlet runs on the local cluster.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalsePrompts 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: FalseRuns the cmdlet without prompting for confirmation. By default the cmdlet will ask for confirmation from the user before proceeding.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseSpecifies the cluster to destroy.
Type: PSObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: FalseShows what would happen if the cmdlet runs. The cmdlet isn't run.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: FalseThis cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.