PowerShell Logo Small


This is the built-in help made by Microsoft for the command 'Update-StorageProviderCache', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.


Updates the cache of the service for a particular provider and associated child objects.


Update-StorageProviderCache [[-Name] <String[]>] [-AsJob] [-CimSession <CimSession[]>] [-DiscoveryLevel <DiscoveryLevel>] [-Manufacturer <String[]>] [-PassThru] [-RootObject
<PSReference>] [-ThrottleLimit <Int32>] [<CommonParameters>]
Update-StorageProviderCache [-AsJob] [-CimSession <CimSession[]>] [-DiscoveryLevel <DiscoveryLevel>] [-PassThru] [-RootObject <PSReference>] [-ThrottleLimit <Int32>]
-InputObject <CimInstance[]> [<CommonParameters>]
Update-StorageProviderCache [-AsJob] [-CimSession <CimSession[]>] [-DiscoveryLevel <DiscoveryLevel>] [-Manufacturer <String[]>] [-PassThru] [-RootObject <PSReference>]
[-ThrottleLimit <Int32>] [-URI <Uri[]>] [<CommonParameters>]
Update-StorageProviderCache [-AsJob] [-CimSession <CimSession[]>] [-DiscoveryLevel <DiscoveryLevel>] [-PassThru] [-RootObject <PSReference>] [-ThrottleLimit <Int32>]
[-UniqueId <String[]>] [<CommonParameters>]
Update-StorageProviderCache [-AsJob] [-CimSession <CimSession[]>] [-DiscoveryLevel <DiscoveryLevel>] [-PassThru] [-RootObject <PSReference>] [-StorageSubSystem
<CimInstance>] [-ThrottleLimit <Int32>] [<CommonParameters>]

Search powershellhelp.space


The Update-StorageProviderCache cmdlet updates the cache of the service for a particular provider and associated child objects.

Note: Using the Full value for the DiscoveryLevel parameter without using additional parameters to limit the scope to particular storage providers or storage subsystems
causes all accessible storage providers to enumerate and report all state information, which can be extremely time intensive in large environments.



Online Version: http://go.microsoft.com/fwlink/?LinkID=307044




Example 1: Perform a Full update of all objects

PS C:\>Update-StorageProviderCache -DiscoveryLevel Full

This example performs a Full update of the storage provider cache on all accessible storage providers, rescanning all associated physical disks and reporting the state. This
operation can be extremely time intensive in large or enterprise environments; instead use parameters to scope the update.

Example 2: Update PhysicalDisk objects for a particular storage provider

PS C:\>Update-StorageProviderCache -StorageSubSystem (Get-StorageSubSystem -FriendlyName "StorageArray*") -DiscoveryLevel Level3

This example uses the StorageSubsystem parameter in association with the Get-StorageSubSystem cmdlet to get a particular storage subsystem and then perform a Level3 update
on its associated storage provider, discovering all associated PhysicalDisk objects.

Example 3: Update all objects for a specific storage pool

PS C:\>Update-StorageProviderCache -Name "StorageArray" -RootObject ([ref](Get-StoragePool "Storage pool"))

This example uses the Name parameter to specify the storage provider to update, and uses the RootObject parameter to specify the specific storage pool for which to update
objects. Because RootObject takes PSReference objects as input, you need to prepend the object call with [ref] to get a reference to the object instead of the object itself.