NAME

Remove-DcsUserOwnership

SYNOPSIS

Removes ownership of a virtual disk from a user.

SYNTAX

Remove-DcsUserOwnership -Ownership <Object> [ -Connection <String> ] [ -PipelineVariable <String> ]

Remove-DcsUserOwnership [ -User <Object> ] [ -Object <Object> ] [ -Connection <String> ] [ -PipelineVariable <String> ]

DESCRIPTION

Removes ownership of a virtual disk from a user. Removing ownership prevents the user from performing operations on the virtual disk. Ownership can be removed for all virtual disks for a specified user, all users for a specified virtual disk, or a specified virtual disk for a specified user.

PARAMETERS

-Ownership<Object>: OwnershipData object, ID, or caption that identifies the user and object to remove from ownership. The OwnershipData object and ID can be obtained from Get-DcsUserOwnership. The caption can be obtained from the OwnershipData object.; Required: true; Position: 1; Default value:; Accept pipeline input: false; Accept wildcard characters: false
-Connection<String>: Alias of the connection to the server group. If not specified, the default connection is used.; Required: false; Position: named; Default value:; Accept pipeline input: false; Accept wildcard characters: false
-PipelineVariable<String>: Required: false; Position: named; Default value:; Accept pipeline input: false; Accept wildcard characters: false
-User<Object>: UserData object, name (caption) or ID that identifies a user. This parameter can be used instead of the Ownership parameter. If User is specified with an object, ownership for the specified object will be removed from the specified user. If user is specified without the object, all ownership for that user will be removed. The UserData object can be obtained from the cmdlet Get-DcsUser.; Required: false; Position: 1; Default value:; Accept pipeline input: false; Accept wildcard characters: false
-Object<Object>: The VirtualDiskData object, ID, or extended caption that identifies a virtual disk from which to remove the user ownership. This parameter can be used instead of the Ownership parameter. If the object is specified with a user, ownership for the specified object will be removed from the specified user. If object is specified without the user, all ownership for that object will be removed. The object for a virtual disk can be retrieved from Get-DcsVirtualDisk. The extended caption is found in the object and consists of the name and server group, for example "Virtual disk 1 from Server Group 1".; Required: false; Position: 2; Default value:; Accept pipeline input: true (ByValue); Accept wildcard characters: false

INPUTS

VirtualDiskData : Object that identifies and describes a virtual disk, used for the Object parameter.

OUTPUTS

NOTES

Also see Add-DcsUserOwnership, Get-DcsUserOwnership.

EXAMPLES

-------------- Example 1 Removes ownership of all virtual disks from a specified user. --------------

Remove-DcsUserOwnership -User "JSchmoe"

The cmdlet is invoked to remove ownership of all virtual disks from the user named "JSchmoe".

-------------- Example 2 Removes ownership of a specific virtual disk from a specific user --------------

Remove-DcsUserOwnership -User "JSchmoe" -Object (Get-DcsVirtualDisk -VirtualDisk "Virtual disk 1")

The cmdlet Remove-DcsUserOwnership is invoked to remove ownership of the virtual disk named "Virtual disk 1" from the user named "JSchmoe". The cmdlet Get-DcsVirtualDisk is used to obtain the VirtualDiskData object for "Virtual disk 1".