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
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 |
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 |