file.cache.pin

Pins a cached payload so cache cleanup will not remove it.

CategoryGeneral
ComponentServer console
Riskmedium
Requires reasonNo
Last verified2026-07-13

Allowed Sources

Lanview ConsoleLocal Server ConsoleBatch

Description

Pins a cached payload so cache cleanup will not remove it. Sets RetentionMode=Pinned on the uploaded payload metadata. Ambiguous file names are refused; use PayloadId in that case. Does not move the payload into Repository\\Software and does not make it a package repository item.

Syntax

file.cache.pin <PayloadId|filename>

Parameters

ParameterUseDescription
<PayloadId|filename>RequiredFull PayloadId, unique short PayloadId, or exact cached original file name.

Permissions

packages.publish

Audit Events

Needs review

Server, Client and Studio Involvement

Needs review

Common Issues

  • The command may require an authenticated server console or named-pipe admin console session.
  • Targeted commands may fail if a device is offline, unapproved or not eligible.

Troubleshooting Notes

Needs review.