Clear-ClusterDiskReservation

Clear-ClusterDiskReservation

Clears the persistent reservation on a disk in a failover cluster.

Syntax

Parameter Set: Default
Clear-ClusterDiskReservation [[-Node] <StringCollection> ] -Disk <UInt32[]> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]




Detailed Description

The Clear-ClusterDiskReservation cmdlet clears the persistent reservation on a disk in a failover cluster. This cmdlet prompts for confirmation unless you specify the Force parameter.

Note: This cmdlet cannot be run remotely without Credential Security Service Provider (CredSSP) authentication on the server computer.

Parameters

-Disk<UInt32[]>

Specifies the disk number on which to clear the persistent reservations. This is the disk number as it appears in Disk Management on the node.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Force

Forces the command to run without asking for user confirmation.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Node<StringCollection>

Specifies the name of the cluster node on which to clear the disk reservation.


Aliases

none

Required?

false

Position?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.


Required?

false

Position?

named

Default Value

false

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

The input type is the type of the objects that you can pipe to the cmdlet.

  • None

Outputs

The output type is the type of the objects that the cmdlet emits.

  • None

Examples

Example 1: Remove reservation on a disk on the local node

This example clears the persistent reservation on disk 5 on the local node after asking for user confirmation.


PS C:\> Clear-ClusterDiskReservation -Disk 5

Example 2: Remove reservation without confirmation

This example clears the persistent reservation on disk 6 on the node named node2 without asking for user confirmation.


C:\PS>Clear-ClusterDiskReservation -Disk 6 -Node "node2" -Force

Related topics

Community Additions

ADD
Show: