Get-AzAppConfigurationSnapshot
Gets a single key-value snapshot or lists key-value snapshots.
Syntax
List (Default)
Get-AzAppConfigurationSnapshot
-Endpoint <String>
[-Name <String>]
[-After <String>]
[-Status <System.Collections.Generic.List`1[System.String]>]
[-Select <System.Collections.Generic.List`1[System.String]>]
[-SyncToken <String>]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Get
Get-AzAppConfigurationSnapshot
-Endpoint <String>
[-Name <String>]
[-Select <System.Collections.Generic.List`1[System.String]>]
[-SyncToken <String>]
[-ClientRequestId <String>]
[-IfMatch <String>]
[-IfNoneMatch <String>]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Description
Gets a single key-value snapshot by name, or lists key-value snapshots with optional filtering.
Examples
Example 1: List all snapshots in an App Configuration store
Get-AzAppConfigurationSnapshot -Endpoint $endpoint
Name Status CompositionType Created Expires RetentionPeriod Size ItemsCount Etag
---- ------ --------------- ------- ------- --------------- ---- ---------- ----
mySnapshot ready key 7/21/2023 02:40:00 3600 1024 5 abcdef
List all key-value snapshots in an App Configuration store.
Example 2: Get a specific snapshot by name
Get-AzAppConfigurationSnapshot -Endpoint $endpoint -Name "mySnapshot"
Name Status CompositionType Created Expires RetentionPeriod Size ItemsCount Etag
---- ------ --------------- ------- ------- --------------- ---- ---------- ----
mySnapshot ready key 7/21/2023 02:40:00 3600 1024 5 abcdef
Get a single key-value snapshot by name from an App Configuration store.
Parameters
-After
Instructs the server to return elements that appear after the element referred to by the specified token.
Parameter properties
Type: String
Default value: None
Supports wildcards: False
DontShow: False
Parameter sets
List
Position: Named
Mandatory: False
Value from pipeline: False
Value from pipeline by property name: False
Value from remaining arguments: False
-ClientRequestId
An opaque, globally-unique, client-generated string identifier for the request.
Parameter properties
Type: String
Default value: None
Supports wildcards: False
DontShow: False
Parameter sets
Get
Position: Named
Mandatory: False
Value from pipeline: False
Value from pipeline by property name: False
Value from remaining arguments: False
-DefaultProfile
The DefaultProfile parameter is not functional.
Use the SubscriptionId parameter when available if executing the cmdlet against a different subscription.
Parameter properties
Type: PSObject
Default value: None
Supports wildcards: False
DontShow: False
Aliases: AzureRMContext, AzureCredential
Parameter sets
(All)
Position: Named
Mandatory: False
Value from pipeline: False
Value from pipeline by property name: False
Value from remaining arguments: False
-Endpoint
The endpoint of the App Configuration instance to send requests to.
Parameter properties
Type: String
Default value: None
Supports wildcards: False
DontShow: False
Parameter sets
(All)
Position: Named
Mandatory: True
Value from pipeline: False
Value from pipeline by property name: False
Value from remaining arguments: False
-IfMatch
Used to perform an operation only if the targeted resource's etag matches the value provided.
Parameter properties
Type: String
Default value: None
Supports wildcards: False
DontShow: False
Parameter sets
Get
Position: Named
Mandatory: False
Value from pipeline: False
Value from pipeline by property name: False
Value from remaining arguments: False
-IfNoneMatch
Used to perform an operation only if the targeted resource's etag does not match the value provided.
Parameter properties
Type: String
Default value: None
Supports wildcards: False
DontShow: False
Parameter sets
Get
Position: Named
Mandatory: False
Value from pipeline: False
Value from pipeline by property name: False
Value from remaining arguments: False
-Name
The name of the snapshot.
When used with the Get parameter set, retrieves a single snapshot by exact name.
When used with the List parameter set, filters the returned snapshots by name.
Parameter properties
Type: String
Default value: None
Supports wildcards: False
DontShow: False
Parameter sets
(All)
Position: Named
Mandatory: False
Value from pipeline: False
Value from pipeline by property name: False
Value from remaining arguments: False
-Select
Used to select what fields are present in the returned resource(s).
Parameter properties
Type: List<T> [ String ]
Default value: None
Supports wildcards: False
DontShow: False
Parameter sets
(All)
Position: Named
Mandatory: False
Value from pipeline: False
Value from pipeline by property name: False
Value from remaining arguments: False
-Status
Used to filter returned snapshots by their status property.
Parameter properties
Type: List<T> [ String ]
Default value: None
Supports wildcards: False
DontShow: False
Parameter sets
List
Position: Named
Mandatory: False
Value from pipeline: False
Value from pipeline by property name: False
Value from remaining arguments: False
-SyncToken
Used to guarantee real-time consistency between requests.
Parameter properties
Type: String
Default value: None
Supports wildcards: False
DontShow: False
Parameter sets
(All)
Position: Named
Mandatory: False
Value from pipeline: False
Value from pipeline by property name: False
Value from remaining arguments: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see
about_CommonParameters .
Outputs