NAME

Get-DcsUserOwnership

SYNOPSIS

Returns ownership data for virtual disks.

SYNTAX

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

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

DESCRIPTION

Returns ownership data for virtual disks. The cmdlet can be used to obtain all owners of a specified virtual disk or all virtual disks owned by a specified user.

PARAMETERS

-User<Object>
UserData object, name, or ID that identifies a user. If specified, only data for that user will be returned.

Required: false
Position: 1
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-Object<Object>
The VirtualDiskData object, name, or ID the identifies the virtual disk. The object and ID can be obtained from the cmdlet Get-DcsVirtualDisk. If specified, only ownership data for that virtual disk will be returned.

Required: false
Position: 2
Default value:
Accept pipeline input: true (ByValue)
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

-Ownership<Object>
The OwnershipData object, or ID the identifies the ownership object. If specified, only data for that ownership object will be returned.

Required: true
Position: 1
Default value:
Accept pipeline input: false
Accept wildcard characters: false

INPUTS

VirtualDiskData : Object that identifies and describes a virtual disk.

OUTPUTS

OwnershipData : Object that identifies and describes an ownership relationship between a user and a virtual disk.

NOTES

Also see Add-DcsUserOwnership, Remove-DcsUserOwnership

EXAMPLES


-------------- Example 1 Returns all data for a particular virtual disk --------------
Get-DcsVirtualDisk -VirtualDisk "Virtual disk 1" | Get-DcsUserOwnership
		

The cmdlet Get-DcsVirtualDisk is invoked to obtain the VirtualDiskData object for"Virtual disk 1". The result is piped to the cmdlet Get-DcsOwnership. The OwnershipData objects for each owner of that virtual disk are returned.

UserId:39cb3daf-5d18-42ba-a3a9-13e5c3782c8a
IdentifiableId:a354eee825cb408a9a4858323d301ae3
Sequencenumber:4102
Id:9f9332a1-675c-4786-b570-f953bd45dbe9
Caption:
ExtendedCaption:
Internal:False
   
UserId:cba8d0fd-7a21-45bd-b6be-360f9447b1c5
IdentifiableId:a354eee825cb408a9a4858323d301ae3
Sequencenumber:4111
Id:7068dc7b-cc3e-4bb8-acd2-be7683ce30ac
Caption:
ExtendedCaption:
Internal:False
   

-------------- Example 2 Returns all data for a specified user. --------------
Get-DcsUserOwnership -User "JSchmoe"
		

The cmdlet is invoked with the user name "JSchmoe" to return all virtual disks that are owned by the specified user.

UserId:39cb3daf-5d18-42ba-a3a9-13e5c3782c8a
IdentifiableId:a354eee825cb408a9a4858323d301ae3
Sequencenumber:4102
Id:9f9332a1-675c-4786-b570-f953bd45dbe9
Caption:
ExtendedCaption:
Internal:False
   
UserId:39cb3daf-5d18-42ba-a3a9-13e5c3782c8a
IdentifiableId:704da63e20ad4eaaa9e4701bb7bc5fbc
Sequencenumber:4104
Id:97404981-9e0d-48bd-8ed8-5994f753125e
Caption:
ExtendedCaption:
Internal:False
   
UserId:39cb3daf-5d18-42ba-a3a9-13e5c3782c8a
IdentifiableId:0c3e004607a04864bdb507ccb09f641c
Sequencenumber:4106
Id:51424fac-2c66-4462-b545-0a7a8e9aa7e1
Caption:
ExtendedCaption:
Internal:False