Invoke-RefresherDataset
This PowerShell cmdlet enables the user to refresh a pre-configured dataset in the cache at runtime, ensuring real-time data freshness and keeping cache data up to date with the backend. The dataset is refreshed according to the specified RefreshPreference, allowing either an immediate refresh (RefreshNow) or a scheduled refresh within the next configured time window (RefreshOnNextTimeOfDay).
Invoke-RefresherDataset -CacheName [-Port] [-Server] -Dataset [-RefreshPreference] [-Credentials] [-NoLogo]
Examples
- This command refreshes the dataset product immediately on demoCache on server 20.200.20.11.
Invoke-RefresherDataset -CacheName demoCache -Server 20.200.20.11 -Dataset product -RefreshPreference RefreshNow
- This command refreshes the dataset product at the configured time of the dataset on demoCache within the next 24 hours. If the specified dataset is a loader-only dataset, its refresh preference is treated the same as
RefreshNow.
Invoke-RefresherDataset -CacheName demoCache -Server 20.200.20.11 -Dataset product -RefreshPreference RefreshOnNextTimeOfDay
- This command refreshes the dataset product immediately on demoCache on server 20.200.20.11, using security credentials.
Invoke-RefresherDataset -CacheName demoCache -Server 20.200.20.11 -Dataset product -RefreshPreference RefreshNow -Credentials(Get-Credential john_smith)
Properties
Note
The parameters with asterisk (*) on their names are the required parameters and the rest are optional.
| Parameters | Data Types | Description | Default Value |
|---|---|---|---|
-CacheName* |
<String> |
Specifies the name of the cache registered on the server. Note: The cache must already exist on the source server. |
- |
-Port |
<Integer> |
Specifies the server port where NCache Service is listening. | 8250 |
-Server |
<String> |
Specifies a server name where the NCache Service is running and a cache with the specified cache-name is registered. | IP of local machine |
-Dataset* |
<String> |
Specifies the name of the pre-configured dataset registered on the cache. | - |
-Credentials |
<pscredential> |
Specifies the user credentials required to authorize access for the specified operation. These credentials should belong to a user with the appropriate permissions at the node. | - |
-RefreshPreference |
<String> |
Specifies whether to refresh the dataset immediately or anytime within next 24 hours. Possible values are:
|
- |
-NoLogo |
<SwitchParameter> |
Suppresses display of the logo banner. | False |
