More edits

Author: JasonGerend

docset/winserver2025-ps/VMDirectStorage/Add-VMDirectVirtualDisk.md

@@ -12,7 +12,7 @@ ai-usage: ai-generated
 
 ## Synopsis
 
-Attaches a Storage Spaces Direct virtual disk to a virtual machine.
+Directly attaches a Storage Spaces Direct virtual disk to a virtual machine.
 
 ## Syntax
 
@@ -41,13 +41,26 @@ Add-VMDirectVirtualDisk [-VMDriveController] <VMDriveController> [-ControllerLoc
 
 ## Description
 
-The **Add-VMDirectVirtualDisk** cmdlet attaches a Storage Spaces Direct virtual disk to a virtual
-machine. This enables high-performance storage configurations by directly connecting the virtual
-disk to the VM.
+The **Add-VMDirectVirtualDisk** cmdlet directly attaches a Storage Spaces Direct virtual disk to a
+virtual machine. This enables high-performance storage configurations by directly connecting the
+virtual disk to the VM.
 
 ## Examples
 
-### Example 1: Attach a virtual disk by specifying VM name and controller details
+### Example 1: Attach a virtual disk by using a virtual disk object
+
+This example gets the Storage Spaces Direct virtual disk object named `Volume01` and the VM object
+named `VM1` on `Cluster01`, and then directly attaches the disk to the VM, using the first available
+controller and controller location.
+
+```powershell
+$VirtualDisk = Get-VirtualDisk -FriendlyName "Volume01" -CimSession "Cluster01"
+$vm = Get-VM -Name "VM1" -CimSession "Cluster01"
+
+Add-VMDirectVirtualDisk -VM $vm -VirtualDiskUniqueId $VirtualDisk.UniqueId
+```
+
+### Example 2: Attach a virtual disk by specifying VM name and controller details
 
 This example attaches the virtual disk with the unique ID `111BBE22FD037E4EB87F366648FBF111` to the
 virtual machine named `VM1` at controller 0, location 1.
@@ -64,25 +77,27 @@ $parameters = @{
 Add-VMDirectVirtualDisk @parameters
 ```
 
-### Example 2: Attach a virtual disk by using a virtual disk object
+### Example 3: Attach multiple virtual disks to a VM
 
-This example gets the Storage Spaces Direct virtual disk object named `Volume01` and the VM object
-named `VM1`, and then directly attaches the disk to the VM.
+This example retrieves all virtual disks with names starting with `Volume0` from the cluster named
+`Cluster01` and attaches them to the virtual machine named `VM1`.
 
 ```powershell
-$virtualDisk = Get-VirtualDisk -Friendlyname "Volume01"
-$vm = Get-VM -Name "VM1"
+$VirtualDisks = Get-VirtualDisk -FriendlyName "Volume0*" -CimSession "Cluster01"
+$vm = Get-VM -Name "VM1" -CimSession "Cluster01"
 
-Add-VMDirectVirtualDisk -VM $vm -VirtualDiskUniqueId $virtualDisk.UniqueId
+foreach ($diskID in $virtualdisks) {
+ Add-VMDirectVirtualDisk -VM $vm -VirtualDiskUniqueId $diskID.UniqueID
+}
 ```
 
 ## Parameters
 
 ### -CimSession
 
-Runs the command using the specified CIM session. Enter a variable that contains the CIM session, or
-a command that creates or gets the CIM session, such as `New-CimSession` or `Get-CimSession`. For more
-information, see
+Runs the cmdlet in a remote session or on a remote computer. Enter a computer name, cluster name, or
+a session object, such as the output of a `New-CimSession` or `Get-CimSession` cmdlet. The default
+is the current session on the local computer. For more information, see
 [about_CimSession](/powershell/module/microsoft.powershell.core/about/about_cimsession).
 
 ```yaml
@@ -99,7 +114,8 @@ Accept wildcard characters: False
 
 ### -ControllerLocation
 
-Specifies the location on the controller where the virtual disk will be attached.
+Specifies the location on the controller where the virtual disk will be attached. If you don't
+specify a controller location, the cmdlet uses the first available location.
 
 ```yaml
 Type: System.Int32
@@ -115,7 +131,8 @@ Accept wildcard characters: False
 
 ### -ControllerNumber
 
-Specifies the number of the controller where the virtual disk will be attached.
+Specifies the number of the controller where the virtual disk will be attached. If you don't specify
+a controller number, the cmdlet uses the first available controller.
 
 ```yaml
 Type: System.Int32
@@ -131,7 +148,8 @@ Accept wildcard characters: False
 
 ### -ControllerType
 
-Specifies the type of controller. Only SCSI is supported.
+Specifies the type of controller used by the VM. If you don't specify a controller type, the cmdlet
+uses the SCSI controller type, which is the only type supported at this time.
 
 ```yaml
 Type: ControllerType
@@ -148,7 +166,8 @@ Accept wildcard characters: False
 
 ### -VirtualDiskUniqueId
 
-Specifies the unique ID of the virtual disk to attach.
+Specifies the unique ID of the Storage Spaces virtual disk to attach. For example,
+`111BBE22-FD03-7E4E-B87F-366648FBF111`.
 
 ```yaml
 Type: System.String
@@ -164,7 +183,7 @@ Accept wildcard characters: False
 
 ### -VM
 
-Specifies the virtual machine object to which the virtual disk will be attached.
+Specifies a virtual machine object to which the virtual disk will be attached.
 
 ```yaml
 Type: Microsoft.HyperV.PowerShell.VirtualMachine[]
@@ -221,21 +240,24 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 ### System.String[]
 
-Specifies the names of virtual machines.
+Specifies the name of a virtual machine.
 
 ### Microsoft.HyperV.PowerShell.VirtualMachine[]
 
-Specifies virtual machine objects.
+Specifies a virtual machine object to which the virtual disk will be attached. You can use the
+[Get-VM](/powershell/module/hyper-v/get-vm) cmdlet to get the virtual machine object.
 
 ### Microsoft.HyperV.PowerShell.VMDriveController
 
-Specifies drive controller objects.
+Specifies a drive controller object to which the virtual disk will be attached. You can use
+the [Get-VmScsiController](/powershell/module/hyper-v/get-vmscsicontroller) cmdlet to get the drive
+controller object.
 
 ## Outputs
 
-### System.Object
+### None
 
-Returns an object representing the result of the operation.
+This cmdlet returns no output of its own.
 
 ## Notes
 

docset/winserver2025-ps/VMDirectStorage/Get-VMDirectVirtualDisk.md

@@ -45,12 +45,13 @@ name, and its location on the controller.
 
 ## Examples
 
-### Example 1: Retrieve virtual disks by virtual machine name
+### Example 1: Retrieve directly attached virtual disks by VM name
 
-This command retrieves all virtual disks attached to the virtual machine named "VM1".
+This command retrieves all virtual disks attached to the virtual machine named `VM1` running on the
+cluster named `Cluster01`.
 
 ```powershell
-Get-VMDirectVirtualDisk -VMName "VM1"
+Get-VMDirectVirtualDisk -VMName "VM1" -CimSession "Cluster01"
 ```
 
 ```Output
@@ -59,23 +60,42 @@ VMName ControllerType ControllerNumber ControllerLocation VirtualDiskFriendlyNam
 VM1    SCSI           0                1                  Volume01                111BBE22FD037E4E...
 ```
 
-### Example 2: Retrieve virtual disks by virtual machine object
+### Example 2: Retrieve directly attached virtual disks by VM object
 
-This command gets the virtual machine object for "VM1" and then retrieves its directly attached
-virtual disks.
+This command gets the virtual machine object for `VM1` running on `Cluster01` and then retrieves its
+directly attached virtual disks.
 
 ```powershell
-$vm = Get-VM -Name "VM1"
+$vm = Get-VM -Name "VM1" -CimSession "Cluster01"
 Get-VMDirectVirtualDisk -VM $vm
 ```
 
+### Example 3: Retrieve virtual disks by drive controller object
+
+This command gets the drive controller object for the virtual machine named `VM1` running on
+`Cluster01` and retrieves the directly attached virtual disks.
+
+```powershell
+$vm = Get-VM -Name "VM1" -CimSession "Cluster01"
+$controller = Get-VMScsiController -VMName "VM1" -CimSession "Cluster01"
+
+Get-VMDirectVirtualDisk -VMDriveController $controller
+```
+
+```Output
+VMName ControllerType ControllerNumber ControllerLocation VirtualDiskFriendlyName VirtualDiskUniqueId
+------ -------------- ---------------- ------------------ ----------------------- -------------------
+VM1    SCSI           0                1                  Volume01                111BBE22FD037E4E...
+VM1    SCSI           0                2                  Volume02                222BBE22FD037E4E...
+```
+
 ## Parameters
 
 ### -CimSession
 
-Runs the command using the specified CIM session. Enter a variable that contains the CIM session, or
-a command that creates or gets the CIM session, such as `New-CimSession` or `Get-CimSession`. For more
-information, see
+Runs the cmdlet in a remote session or on a remote computer. Enter a computer name, cluster name, or
+a session object, such as the output of a `New-CimSession` or `Get-CimSession` cmdlet. The default
+is the current session on the local computer. For more information, see
 [about_CimSession](/powershell/module/microsoft.powershell.core/about/about_cimsession).
 
 ```yaml
@@ -92,7 +112,8 @@ Accept wildcard characters: False
 
 ### -ControllerLocation
 
-Specifies the location of the virtual disk on the controller.
+Specifies the location of the virtual disk on the controller. If you don't specify a controller
+location, the cmdlet returns all virtual disks attached to the specified controller.
 
 ```yaml
 Type: System.Int32
@@ -108,7 +129,8 @@ Accept wildcard characters: False
 
 ### -ControllerNumber
 
-Specifies the number of the controller where the virtual disk is attached.
+Specifies the number of the controller where the virtual disk is attached. If you don't specify a
+controller number, the cmdlet returns all virtual disks attached to the specified controller.
 
 ```yaml
 Type: System.Int32
@@ -124,7 +146,8 @@ Accept wildcard characters: False
 
 ### -ControllerType
 
-Specifies the type of controller. Only SCSI is supported.
+Specifies the type of controller used by the VM. If you don't specify a controller type, the cmdlet
+uses the SCSI controller type, which is the only type supported at this time.
 
 ```yaml
 Type: ControllerType
@@ -157,7 +180,8 @@ Accept wildcard characters: False
 
 ### -VMDriveController
 
-Specifies the drive controller object for which to retrieve virtual disk information.
+Specifies the drive controller object for which to retrieve virtual disk information. You can use
+the [Get-VmScsiController](/powershell/module/hyper-v/get-vmscsicontroller) cmdlet to get the drive controller object.
 
 ```yaml
 Type: Microsoft.HyperV.PowerShell.VMDriveController[]
@@ -198,15 +222,35 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 ### System.String[]
 
-Specifies the names of virtual machines.
+Specifies the name of a virtual machine.
+
+### Microsoft.HyperV.PowerShell.VirtualMachine[]
+
+Specifies the virtual machine object for which to get directly attached virtual disks. You can use
+the [Get-VM](/powershell/module/hyper-v/get-vm) cmdlet to get the virtual machine object.
+
+### Microsoft.HyperV.PowerShell.VMDriveController[]
+
+Specifies the drive controller objects for which to get directly attached virtual disks. You can use
+the [Get-VmScsiController](/powershell/module/hyper-v/get-vmscsicontroller) cmdlet to get the drive
+controller object.
+
+## Inputs
+
+### System.String[]
+
+Specifies the name of a virtual machine.
 
 ### Microsoft.HyperV.PowerShell.VirtualMachine[]
 
-Specifies virtual machine objects.
+Specifies the virtual machine object for which to get directly attached virtual disks. You can use
+the [Get-VM](/powershell/module/hyper-v/get-vm) cmdlet to get the virtual machine object.
 
 ### Microsoft.HyperV.PowerShell.VMDriveController[]
 
-Specifies drive controller objects.
+Specifies the drive controller objects for which to get directly attached virtual disks. You can use
+the [Get-VmScsiController](/powershell/module/hyper-v/get-vmscsicontroller) cmdlet to get the drive
+controller object.
 
 ## Outputs
 

docset/winserver2025-ps/VMDirectStorage/Remove-VMDirectVirtualDisk.md

@@ -39,7 +39,7 @@ virtual machine. This operation ensures that the virtual disk is no longer acces
 ### Example 1: Detach a virtual disk by specifying VM name and controller details
 
 This command detaches the virtual disk located at controller 0, location 1, from the virtual machine
-named "VM1".
+named `VM1`.
 
 ```powershell
 $parameters = @{
@@ -53,20 +53,20 @@ Remove-VMDirectVirtualDisk @parameters
 
 ### Example 2: Detach a virtual disk by using the virtual disk object
 
-This example gets the virtual disk object attached to "VM1" and then removes it.
+This example gets the virtual disk object attached to `VM1` on `Cluster01` and then removes it.
 
 ```powershell
-$virtualDisk = Get-VMDirectVirtualDisk -VMName "VM1"
-Remove-VMDirectVirtualDisk -VirtualDisk $virtualDisk
+$VmDirectDisk = Get-VMDirectVirtualDisk -VMName "VM1" -CimSession "Cluster01"
+Remove-VMDirectVirtualDisk -VirtualDisk $VmDirectDisk
 ```
 
 ## Parameters
 
 ### -CimSession
 
 Runs the command using the specified CIM session. Enter a variable that contains the CIM session, or
-a command that creates or gets the CIM session, such as `New-CimSession` or `Get-CimSession`. For more
-information, see
+a command that creates or gets the CIM session, such as `New-CimSession` or `Get-CimSession`. For
+more information, see
 [about_CimSession](/powershell/module/microsoft.powershell.core/about/about_cimsession).
 
 ```yaml
@@ -181,9 +181,9 @@ Specifies the virtual disk objects to be detached.
 
 ## Outputs
 
-### System.Object
+### None
 
-Returns an object representing the result of the operation.
+This cmdlet returns no output of its own.
 
 ## Notes