Set-BCCache

Set-BCCache

Modifies the cache file configuration.

Sintaxis

Parameter Set: Path
Set-BCCache [[-Path] <String> ] [-AsJob] [-CimSession <CimSession[]> ] [-Defragment] [-Force] [-MoveTo <String> ] [-PassThru] [-Percentage <UInt32> ] [-SizeBytes <UInt64> ] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: Cache
Set-BCCache [-Cache] <CimInstance[]> [-AsJob] [-CimSession <CimSession[]> ] [-Defragment] [-Force] [-MoveTo <String> ] [-PassThru] [-Percentage <UInt32> ] [-SizeBytes <UInt64> ] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Descripción detallada

The Set-BCCache cmdlet modifies the cache file configuration. Use the Cache parameter to specify which cache should be configured.

Parámetros

-AsJob

-Cache<CimInstance[]>

Specifies the cache which should be modified.

-CimSession<CimSession[]>

Ejecuta el cmdlet en una sesión remota o en un equipo remoto. Escriba un nombre de equipo o un objeto de sesión, como la salida de un cmdlet New-CimSession o Get-CimSession. El valor predeterminado es la sesión actual en el equipo local.

-Defragment

Specifies that the cache should be defragmented. Fragmented cache files store data less effectively. The BranchCache service detects cache fragmentation and raises an event in the Windows Event Log when it is time to defragment the cache.

-Force

Runs the cmdlet without prompting for confirmation. By default the cmdlet asks for confirmation from the user before proceeding.

-MoveTo<String>

Specifies the new location on disk for this cache file.

-PassThru

Sends items from the interactive window down the pipeline as input to other cmdlets. By default, this cmdlet does not generate any output.
To send items from the interactive window down the pipeline, click to select the items and then click OK. Shift-click and Ctrl-click are supported.

-Path<String>

Runs the cmdlet on the specified cache file.

-Percentage<UInt32>

Specifies the new size of this cache file. The size is a percentage of the disk.

-SizeBytes<UInt64>

Specifies the new size of the cache file.

-ThrottleLimit<Int32>

Especifica el número máximo de operaciones simultáneas que se pueden establecer para ejecutar el cmdlet. Si se omite este parámetro o es especifica un valor de 0, Windows PowerShell ® calcula un límite óptimo para el cmdlet en función del número de cmdlets de CIM que se estén ejecutando en el equipo. El límite solo se aplica al cmdlet actual, no a la sesión ni al equipo.

-Confirm

Solicita confirmación antes de ejecutar el cmdlet.

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

<CommonParameters>

Este cmdlet admite los siguientes parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entradas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet.

• None

Salidas

El tipo de resultado es el tipo de objetos que emite el cmdlet.

• Microsoft.Management.Infrastructure.CimInstance#root\StandardCimV2\MSFT_NetBranchCacheCache[]

  El objeto Microsoft.Management.Infrastructure.CimInstance es una clase contenedora que muestra objetos de Instrumental de administración de Windows (WMI). La ruta de acceso después del signo de número (#) proporciona el espacio de nombres y el nombre de clase del objeto WMI subyacente.

Ejemplos

Example 1

This example moves the cache file from C:\datacache to D:\datacache.

PS C:\> Set-BCCache -Path C:\datacache –MoveTo D:\datacache

Example 2

This example increases data cache files from 10% to 20%.

PS C:\> Get-BCDataCacheExtension | Where-Object –FilterScript {$_.MaxCacheSizeAsPercentageOfDiskVolume –Eq 10} | Set-BCCache -Percentage 20

Temas relacionados

Clear-BCCache

Get-BCDataCacheExtension

Where-Object