NAME

Get-DcsPhysicalDisk

SYNOPSIS

Returns tdata for physical disks and disks served to clients (hosts).

SYNTAX

Get-DcsPhysicalDisk   [ -Server <Object> ]   [ -Type <String[]> ]   [ -Available]   [ -Disk <Object> ]   [ -Pool <Object> ]   [ -Shared]   [ -PoolMember <Object> ]   [ -SharedDisk <Object> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Get-DcsPhysicalDisk   [ -Server <Object> ]   [ -Type <String[]> ]   [ -Available]   [ -Disk <Object> ]   [ -Pool <Object> ]   [ -Shared]   [ -PoolMember <Object> ]   [ -SharedDisk <Object> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

Get-DcsPhysicalDisk   [ -Server <Object> ]   [ -Type <String[]> ]   [ -Available]   [ -Disk <Object> ]   [ -Pool <Object> ]   [ -NonShared]   [ -PoolMember <Object> ]   [ -SharedDisk <Object> ]   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Returns the data for physical disks and disks served to clients (hosts). Filtering parameters may be specified to narrow the scope of the data returned. If no parameters are specified, data for all physical disks for all servers and all disks served to hosts in the server group will be returned. Notes: As for physical disks that are used as pass-through disks, the entire volume is considered used and the free space will be 0. The free space value for a physical disk is only valid for physical disks that are not Members of a pool. To get accurate and up-to-date values for this case, use the cmdlet Get-DcsPoolMember and pipe the object to Get-DcsPerformanceCounter.

PARAMETERS

-Server<Object>
Computer name or ID of a server. The computer name must be unique or the name must be fully qualified. If specified, only data for that server will be returned.

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

-Type<String[]>
Type of physical disk. More than one type can be specified and only data for the specified types will be returned. Parameter values are "Mirrored", "PassThrough", "PoolDisk", "Basic", "Dynamic", "Uninitialized", and "Unknown". If not specified, data for all types will be returned.

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

-Available<SwitchParameter>
Specify the Available parameter to only return data for physical disks that are available for use, such as disks that are not in disk pools and that are not used as pass-through disks.

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

-Disk<Object>
PhysicalDiskData object, name, or ID that identifies a physical disk. To resolve by name, the name must be unique to the server group or the server must be specified. If the physical disk is specified, only data for that physical disk will be returned.

Required: false
Position: named
Default value:
Accept pipeline input: true (ByValue)
Accept wildcard characters: false

-Pool<Object>
Name, or ID that identifies the disk pool. To resolve by name, the name must be unique to the server group or the server must be specified. If the pool is specified, only data for that pool will be returned.

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

-Shared<SwitchParameter>
Specify this parameter to only return data for shared physical disks.

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

-PoolMember<Object>
ID or caption that identifies a Member of a disk pool. If the pool Member is specified, only data for that pool Member will be returned.

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

-SharedDisk<Object>
Name or Shared Physical Disk ID that identifies a shared physical disk. To resolve by name, the name must be unique to the server group or the server must be specified. If the shared physical disk is specified, only data for that shared physical disk will be returned.

Required: false
Position: named
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

-NonShared<SwitchParameter>
Specify this parameter to only return data for physical disks that are not shared by other servers.

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

INPUTS

PhysicalDiskData : Object identifying and describing the disk.

OUTPUTS

PhysicalDiskData : Object identifying and describing the disk.

NOTES

Also see Add-DcsPoolMember, Get-DcsPoolMember, Get-DcsPoolDiskRelation, Unlock-DcsPhysicalDisk, Get-DcsSharedPhysicalDisk.

EXAMPLES


-------------- Example 1 Returns all uninitialized unitialized physical disk for a specified server --------------
Get-DcsPhysicalDisk -Server "SSVVM01" -Type "Uninitialized"
		

Returns data for all physical disks of type "Uninitialized" for the server "SSVVM01".

PoolMemberId:
HostId:9A622809-4DE6-4B9F-9965-EF29852A1D9E
SharedPhysicalDiskId:
PresenceStatus:Present
Alias:
Size:50 GiB
SectorSize:512 B
FreeSpace:50.00 GiB
InquiryData:DataCoreVirtual Disk DCS 125e932365eb408fa81b0d1fcd997c60
ScsiPath:Port 7, Bus 0, Target 0, LUN 3
DiskIndex:4
SystemName:\\?\PhysicalDrive4
BusType:iScsi
Type:Uninitialized
DiskStatus:Online
Partitioned:False
InUse:False
IsBootDisk:False
Protected:True
IsSolidState:False
UniqueIdentifier:naa.60030d90e3c7bc02ebf5556fb27fd6c3
IsDataCoreDisk:True
Sequencenumber:36441806
Id:{7261a103-2126-42c5-b414-dfa9ac93a9d4}
Caption:DataCoreVirtual Disk
ExtendedCaption:DataCoreVirtual Disk on SSVVM01
Internal:False
   
PoolMemberId:
HostId:9A622809-4DE6-4B9F-9965-EF29852A1D9E
SharedPhysicalDiskId:
PresenceStatus:Present
Alias:
Size:50 GiB
SectorSize:512 B
FreeSpace:50.00 GiB
InquiryData:DataCoreVirtual Disk DCS da8eaa010c154e42881282bbe483e915
ScsiPath:Port 7, Bus 0, Target 0, LUN 2
DiskIndex:3
SystemName:\\?\PhysicalDrive3
BusType:iScsi
Type:Uninitialized
DiskStatus:Online
Partitioned:False
InUse:False
IsBootDisk:False
Protected:True
IsSolidState:False
UniqueIdentifier:naa.60030d9046c7bc02265710f7d15ed3bb
IsDataCoreDisk:True
Sequencenumber:36441796
Id:{676d4f59-2b4d-4079-a496-5b8e30c34724}
Caption:DataCoreVirtual Disk
ExtendedCaption:DataCoreVirtual Disk on SSVVM01
Internal:False
   

-------------- Example 2 Returns data for a specified shared physical disk. --------------
Get-DcsPhysicalDisk -SharedDisk "SSV1-WDC50-D1"
		

The cmdlet is invoked using the SharedDisk parameter and a value of "SSV1-WDC50-D1", which is the unique name of a shared physical disk. Two objects are returned, one for each server sharing the disk.

PoolMemberId:
HostId:8CE05A9F-D367-4BDE-BCE6-67909F6F7F6A
SharedPhysicalDiskId:naa.60030d9056566f6c3231000000000000
PresenceStatus:Present
Alias:SSV1-WDC50-D1
Size:50.00 GiB
SectorSize:512 B
FreeSpace:49.87 GiB
InquiryData:DataCore SANmelody DCS VVol21
ScsiPath:Port 4, Bus 0, Target 4, LUN 6
DiskIndex:9
SystemName:\\?\PhysicalDrive9
BusType:iScsi
Type:Basic
DiskStatus:Offline
Partitioned:False
InUse:False
IsBootDisk:False
Protected:False
UniqueIdentifier:naa.60030d9056566f6c3231000000000000
Sequencenumber:32757
Id:{20b71485-f554-4538-977d-512a15b6d0b0}
Caption:SSV1-WDC50-D1
ExtendedCaption:SSV1-WDC50-D1 on SSV2
Internal:False
   
PoolMemberId:2919eb02-f705-42ec-9ed5-4e2f7a2b7af9
HostId:8BD7BD0F-F5F9-40DB-B8B0-6ABB74D43F81
SharedPhysicalDiskId:naa.60030d9056566f6c3231000000000000
PresenceStatus:Present
Alias:SSV1-WDC50-D1
Size:50.00 GiB
SectorSize:512 B
FreeSpace:49.87 GiB
InquiryData:DataCore SANmelody DCS VVol21
ScsiPath:Port 4, Bus 0, Target 4, LUN 0
DiskIndex:1
SystemName:\\?\PhysicalDrive1
BusType:iScsi
Type:Pool
DiskStatus:Online
Partitioned:True
InUse:True
IsBootDisk:False
Protected:False
UniqueIdentifier:naa.60030d9056566f6c3231000000000000
Sequencenumber:32752
Id:{eaf8d9c0-302b-4c4a-9d37-23b0b407f668}
Caption:SSV1-WDC50-D1
ExtendedCaption:SSV1-WDC50-D1 on SSV1
Internal:False