Set-PSUCache

ÜBERSICHT

Legt ein Objekt im serverseitigen Cache von PowerShell Universal ab.

SYNTAX

None (Standard)

Set-PSUCache -Key <String> -Value <Object> [-Persist] [-Role <String[]>] [-Depth <Int32>]
 [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials]
 [-Integrated] [-TrustCertificate] [-Cookies] [<CommonParameters>]

Absolute

Set-PSUCache -Key <String> -Value <Object> [-AbsoluteExpiration <DateTime>] [-Persist] [-Role <String[]>]
 [-Depth <Int32>] [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>]
 [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
 [<CommonParameters>]

AbsoluteExpirationFromNow

Set-PSUCache -Key <String> -Value <Object> [-AbsoluteExpirationFromNow <TimeSpan>] [-Persist]
 [-Role <String[]>] [-Depth <Int32>] [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>]
 [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
 [<CommonParameters>]

SlidingExpiration

Set-PSUCache -Key <String> -Value <Object> [-SlidingExpiration <TimeSpan>] [-Persist] [-Role <String[]>]
 [-Depth <Int32>] [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>]
 [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
 [<CommonParameters>]

BESCHREIBUNG

Legt ein Objekt im serverseitigen Cache von PowerShell Universal ab. Dieses Cmdlet ist zur Verwendung innerhalb von APIs, Dashboards und Skripten vorgesehen. Sie können Cache-Daten nicht über die Management-API abrufen.

BEISPIELE

Beispiel 1

PS C:\> Set-PSUCache -Key 'Data' -Value 'MyValue'

Speichert Daten dauerhaft im Cache auf Serverebene.

Beispiel 2

PS C:\> Set-PSUCache -Key 'Data' -Value 'MyValue' -AbsoluteExpiration (Get-Date).AddMinutes(10)

Speichert Daten im Cache, die in 10 Minuten ablaufen.

Beispiel 3

PS C:\> Set-PSUCache -Key 'Data' -Value 'MyValue' -AbsoluteExpirationFromNow [TimeSpan]::FromMinutes(30)

Speichert Daten im Cache, die in 30 Minuten ablaufen.

Beispiel 4

PS C:\> Set-PSUCache -Key 'Data' -Value 'MyValue' -SlidingExpiration [TimeSpan]::FromMinutes(10)

Speichert Daten mit einem gleitenden Cache von 10 Minuten im Cache. Wenn nicht innerhalb von 10 Minuten auf die Daten zugegriffen wird, werden sie ungültig und aus dem Cache entfernt. Wenn auf die Daten zugegriffen wird, wird der Timer für weitere 10 Minuten zurückgesetzt.

PARAMETER

-AbsoluteExpiration

Eine absolute Ablaufzeit für die Daten im Cache.

Type: DateTime
Parameter Sets: Absolute
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AbsoluteExpirationFromNow

Ein TimeSpan, der angibt, wie lange von jetzt an die Daten aus dem Cache entfernt werden sollen.

Type: TimeSpan
Parameter Sets: AbsoluteExpirationFromNow
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Key

Ein Schlüssel zum Nachschlagen der Daten im Cache.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SlidingExpiration

Ein TimeSpan, der den gleitenden Ablauf für Daten im Cache angibt.

Type: TimeSpan
Parameter Sets: SlidingExpiration
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Value

Das im Cache zu speichernde Objekt. Dieses Objekt wird in CLIXML serialisiert.

Type: Object
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AppToken

Gibt das App-Token an, das bei der Authentifizierung gegenüber der Management-API von PowerShell Universal verwendet wird.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ComputerName

Gibt die URL oder den Hostnamen der PowerShell Universal-Zielinstanz an. Reine Hostnamen werden zu einer http://<host>:5000-URL normalisiert.

Type: String
Parameter Sets: (All)
Aliases: Uri

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Integrated

Führt den Befehl intern aus, anstatt die Management-API zu verwenden. Funktioniert nur, wenn das Skript innerhalb von PowerShell Universal ausgeführt wird.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UseDefaultCredentials

Stellt Windows-Anmeldeinformationen bei der Authentifizierung gegenüber PowerShell Universal bereit.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Credential

Anmeldeinformationen für die Anmeldung bei der Management-API von PowerShell Universal.

Type: PSCredential
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Persist

Speichert Cache-Daten dauerhaft in der Datenbank.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Role

Die Rollen, die Zugriff auf diese zwischengespeicherten Daten haben.

Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TrustCertificate

Gibt an, ob das Cmdlet Zertifikatsprobleme ignorieren soll.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Cookies

Verwendet und speichert Authentifizierungs-Cookies für die aktuelle PowerShell-Sitzung erneut.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Depth

Gibt die Serialisierungstiefe an, die beim Konvertieren von Werten vor dem Senden an den Server verwendet wird.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable und -ProgressAction. Weitere Informationen finden Sie unter about_CommonParameters.