Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

Stop-IscsiVirtualDiskOperation

Windows Server 2012 R2 and Windows 8.1

Updated: October 17, 2013

Applies To: Windows 8.1, Windows PowerShell 4.0, Windows Server 2012 R2

Stop-IscsiVirtualDiskOperation

Stops a long-running operation in progress on an iSCSI virtual disk.

Syntax

Parameter Set: DevicePath
Stop-IscsiVirtualDiskOperation [-Path] <String> [-ComputerName <String> ] [-Credential <PSCredential> ] [ <CommonParameters>]

Parameter Set: InputObject
Stop-IscsiVirtualDiskOperation -InputObject <IscsiVirtualDisk> [-ComputerName <String> ] [-Credential <PSCredential> ] [ <CommonParameters>]




Detailed Description

The Stop-IscsiVirtualDiskOperation cmdlet stops a long-running operation in progress on an iSCSI virtual disk. If you cancel an operation, it is possible that the operation completes before the cancelation takes effect. Always re-enumerate or recheck objects affected by an operation after this cmdlet finishes.

Stopping a create operation can remove a created file, or can leave the file intact but not completely zero it out.

After you stop an operation, the size of an existing file to be increased can appear larger until the next time you restart the iSCSI service, restart the disk, or disable and re-enable the disk. Some data can be lost.

If you stop an operation, the virtual disk may be in an inconsistent state, and require a new rollback.

This cmdlet accepts values for the ComputerName and Path parameters by using as pipeline input the InputObject parameter.

Parameters

-ComputerName<String>

Specifies the computer name, or IP address, of the remote computer, if this cmdlet is run on a remote computer.

Specifies the cluster resource group network name, or cluster node name, if this cmdlet is run on a cluster configuration.

If you do not specify a value for this parameter, the cmdlet uses the local computer.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Credential<PSCredential>

Specifies the credentials when connecting to a remote computer.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-InputObject<IscsiVirtualDisk>

Specifies an IscsiVirtualDisk object. You can get an IscsiVirtualDisk object by using the Get-IscsiVirtualDisk cmdlet.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Path<String>

Specifies the path of the virtual hard disk (VHDX) file that is associated with the iSCSI virtual disk. The cmdlet stops the long-running operation on the iSCSI virtual disk that you specify.


Aliases

DevicePath

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. 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: Stop a virtual disk operation

This command stops an operation in progress on the virtual disk at the specified location.


PS C:\> Stop-IscsiVirtualDiskOperation -Path "D:\VirtualDisk09"

Related topics

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.