NAME
Unserve-DcsVirtualDisk
SYNOPSIS
Unserves virtual disks from a client host.
SYNTAX
Unserve-DcsVirtualDisk -Machine <String> -VirtualDisk <Object> [ -Connection <String> ] [ -PipelineVariable <String> ]
DESCRIPTION
Unserves virtual disks from a client host. When a virtual disk is unserved, the virtual disk path from the server to the client host is removed and the virtual disk becomes inaccessible to the client host.
PARAMETERS
- -Machine<String>
- Computer name or ID that identifies a server or client host from which to unserve the virtual disk. The computer name for a server must be unique or the names must be fully qualified.
-
- Required: true
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -VirtualDisk<Object>
- VirtualDiskData object, name, or ID that identifies a virtual disk to unserve.
-
- Required: true
- Position: named
- 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 will be 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
-
INPUTS
VirtualDiskData : Object that identifies and describes the virtual disk.
OUTPUTS
NOTES
Also see Serve-DcsVirtualDisk, Get-DcsVirtualDisk.
EXAMPLES
Unserve-DcsVirtualDisk -Machine Host3 -VirtualDisk "Virtual disk 1"
The virtual disk named "Virtual disk 1" is unserved from the machine named "Host3".
Get-DcsVirtualDisk -ServerGroup Local -Machine Host3 | Unserve-DcsVirtualDisk -Machine Host3
The cmdlet Get-DcsVirtualDisk is invoked to obtain VirtualDiskData objects for all virtual disks in the server group named "Local" that are served to the client named "Host3". Those objects are piped to Unserve-DcsVirtualDisk with the machine specified as "Host3". This results in all virtual disks served to Host 3 being unserved.