Get-CloudCacheDisk Cmdlet

Article
02/12/2025

SYNOPSIS

Shows the Cloud Cache disks which are registered for signed in users.

SYNTAX

Path (Default)

Get-CloudCacheDisk
    [-Path <String>]
    [<CommonParameters>]

Id

Get-CloudCacheDisk
    [-Id <Int32>]
    [<CommonParameters>]

DESCRIPTION

This cmdlet lists all the disks registered as the default output. Alternatively, it lists the Cloud Cache disks by path or ID. A Cloud Cache disk is the Proxy file located at: %ProgramData%\FSLogix\Proxy\<profile-directory-name>\<vhd-name>

Properties

Property	Value	Description
ActivityId	`[String]`	Used by Microsoft Support only.
CachePath	`[String]`	The file path to the local cache disk. (`%ProgramData%\FSLogix\Cache`)
CacheSizeOnDisk	`[UInt64]`	The size in bytes of the local Cloud Cache 'cache' disk.
Path	`[String]`	The file path to the local Cloud Cache 'proxy' disk (registered disk).
Id	`[Int32]`	Internal identifier of the registered disk used by the Cloud Cache service.
State	Registered	The local Cloud Cache 'proxy' disk registered and ready for I/O operations.
	WaitingForSync	The Cloud Cache service is holding the sign out process until the remote Cloud Cache disk has completed its sync from another remote provider.
	WaitingForZeroHandleCount	The Cloud Cache service is holding the sign out process until all I/O handles to the Cloud Cache 'proxy' disk have been closed.
	WaitingForUnhealthyProviders	The Cloud Cache service is holding the user sign out process until the UnhealthyProvidersRequiredForUnregister value is met.
	WaitingForWriteQueueFlush	The Cloud Cache service is holding the user sign out process until all changes have been flushed to the remote storage providers.
	Unregistered	The local Cloud Cache 'proxy' disk completed all operations and will soon be removed.

EXAMPLES

Example 1 (Direct attach)

PS C:\> Get-CloudCacheDisk

ActivityId      : d77f1d2a-696f-4d85-a910-2d93e3563828
CachePath       : C:\ProgramData\FSLogix\Cache\jdoe_S-1-5-21-0000000000-568058721-0000000000-1110\Profile_jdoe.VHDX
CacheSizeOnDisk : 78839808
Path            : C:\ProgramData\FSLogix\Proxy\jdoe_S-1-5-21-0000000000-568058721-0000000000-1110\Profile_jdoe.VHDX
Id              : 25
State           : Registered

Shows all registered disks when using ProfileType 0 (direct attach).

Example 2 (Read / Write - fallback Read Only)

PS C:\> Get-CloudCacheDisk

ActivityId      : 25693854-65cf-4781-bb64-68250fe3967f
CachePath       : C:\ProgramData\FSLogix\Cache\jdoe_S-1-5-21-0000000000-568058721-0000000000-1110\RW.VHDX
CacheSizeOnDisk : 748027904
Path            : C:\ProgramData\FSLogix\Proxy\jdoe_S-1-5-21-0000000000-568058721-0000000000-1110\RW.VHDX
Id              : 32
State           : Registered

ActivityId      : a829fe72-ad78-45wh-d885-4258fs0e1359q
CachePath       : C:\ProgramData\FSLogix\Cache\jdoe_S-1-5-21-0000000000-568058721-0000000000-1110\Profile_jdoe.VHDX
CacheSizeOnDisk : 18546688
Path            : C:\ProgramData\FSLogix\Proxy\jdoe_S-1-5-21-0000000000-568058721-0000000000-1110\Profile_jdoe.VHDX
Id              : 33
State           : Registered

Shows all registered disks when using ProfileType 3 (read / write - fallback read only).

Example 3 (Direct attach with wildcard)

PS C:\> Get-CloudCacheDisk *jdoe*

ActivityId      : d77f1d2a-696f-4d85-a910-2d93e3563828
CachePath       : C:\ProgramData\FSLogix\Cache\jdoe_S-1-5-21-0000000000-568058721-0000000000-1110\Profile_jdoe.VHDX
CacheSizeOnDisk : 78839808
Path            : C:\ProgramData\FSLogix\Proxy\jdoe_S-1-5-21-0000000000-568058721-0000000000-1110\Profile_jdoe.VHDX
Id              : 25
State           : Registered

Shows all registered disks for user jdoe (wildcard) when using ProfileType 0 (direct attach).

PARAMETERS

-Id

The Cloud Cache disk registration ID.

Item	Value
Type	`[Int32]`
Parameter Sets	Id
Aliases
Required	False
Position	0
Default value	None
Accept pipeline input	True (ByValue)
Accept wildcard characters	False

-Path

The path to the Cloud Cache disk (wildcards supported).

Item	Value
Type	`[String]`
Parameter Sets	Path
Aliases
Required	False
Position	0
Default value	None
Accept pipeline input	True (ByValue)
Accept wildcard characters	False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Share via