New-AzAppConfigurationSnapshot

モジュール:

Az.AppConfiguration Module

キーと値のスナップショットを作成します。

構文

Create (既定)

New-AzAppConfigurationSnapshot
    -Endpoint <String>
    -Name <String>
    -Entity <ISnapshot>
    [-SyncToken <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonString

New-AzAppConfigurationSnapshot
    -Endpoint <String>
    -Name <String>
    -JsonString <String>
    [-SyncToken <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonFilePath

New-AzAppConfigurationSnapshot
    -Endpoint <String>
    -Name <String>
    -JsonFilePath <String>
    [-SyncToken <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateExpanded

New-AzAppConfigurationSnapshot
    -Endpoint <String>
    -Name <String>
    -Filter <IKeyValueFilter[]>
    [-SyncToken <String>]
    [-CompositionType <String>]
    [-Description <String>]
    [-RetentionPeriod <Int64>]
    [-Tag <Hashtable>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentityExpanded

New-AzAppConfigurationSnapshot
    -Endpoint <String>
    -InputObject <IAppConfigurationdataIdentity>
    -Filter <IKeyValueFilter[]>
    [-SyncToken <String>]
    [-CompositionType <String>]
    [-Description <String>]
    [-RetentionPeriod <Int64>]
    [-Tag <Hashtable>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentity

New-AzAppConfigurationSnapshot
    -Endpoint <String>
    -InputObject <IAppConfigurationdataIdentity>
    -Entity <ISnapshot>
    [-SyncToken <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

キーと値のスナップショットを作成します。

例

例 1: キー フィルターを使用してスナップショットを作成する

$filter = @{ Key = "app/*" }
New-AzAppConfigurationSnapshot -Endpoint $endpoint -Name "mySnapshot" -Filter $filter

Name       Status CompositionType Created               Expires RetentionPeriod Size ItemsCount Etag
----       ------ --------------- -------               ------- --------------- ---- ---------- ----
mySnapshot ready  key             7/21/2023 02:40:00                 3600        1024 5          abcdef

キー フィルター "app/*" に一致するすべてのキー値をキャプチャするキー値スナップショットを作成します。

例 2: 保持期間と構成の種類を持つスナップショットを作成する

$filter = @{ Key = "app/*"; Label = "prod" }
New-AzAppConfigurationSnapshot -Endpoint $endpoint -Name "prodSnapshot" -Filter $filter -CompositionType "key_label" -RetentionPeriod 7776000

Name         Status CompositionType Created               Expires                RetentionPeriod Size ItemsCount Etag
----         ------ --------------- -------               -------                --------------- ---- ---------- ----
prodSnapshot ready  key_label       7/21/2023 02:40:00    10/19/2023 02:40:00    7776000         2048 10         ghijkl

key_labelコンポジションの種類と 90 日間のリテンション期間を含むスナップショットを作成し、キーとラベルの両方でフィルター処理します。

パラメーター

-AsJob

コマンドをジョブとして実行する

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-CompositionType

合成の種類は、スナップショット内のキー値がどのように構成されるかを示します。 'key' コンポジション型では、同じキーを含む 2 つのキー値が存在しないようにします。 "key_label" コンポジション型では、同じキーとラベルを含む 2 つのキー値が存在しないようにします。

パラメーターのプロパティ

型:	String
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

CreateExpanded

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

CreateViaIdentityExpanded

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False
Aliases:	Cf

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-DefaultProfile

DefaultProfile パラメーターは機能しません。 別のサブスクリプションに対してコマンドレットを実行する場合は、使用可能な場合は SubscriptionId パラメーターを使用します。

パラメーターのプロパティ

型:	PSObject
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False
Aliases:	AzureRMContext, AzureCredential

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Description

スナップショットの説明です。

パラメーターのプロパティ

型:	String
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

CreateExpanded

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

CreateViaIdentityExpanded

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Endpoint

要求を送信する App Configuration インスタンスのエンドポイント。

パラメーターのプロパティ

型:	String
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	True
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Entity

スナップショットとは、App Configuration ストアのキーと値に関する名前付きの不変のサブセットを指します。

パラメーターのプロパティ

型:	ISnapshot
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

Create

配置:	Named
必須:	True
パイプラインからの値:	True
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

CreateViaIdentity

配置:	Named
必須:	True
パイプラインからの値:	True
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Filter

スナップショットに含まれるキー値をフィルター処理するために使用されるフィルターの一覧。

パラメーターのプロパティ

型:	IKeyValueFilter[]
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

CreateExpanded

配置:	Named
必須:	True
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

CreateViaIdentityExpanded

配置:	Named
必須:	True
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-InputObject

IDENTITY パラメーター

パラメーターのプロパティ

型:	IAppConfigurationdataIdentity
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

CreateViaIdentityExpanded

配置:	Named
必須:	True
パイプラインからの値:	True
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

CreateViaIdentity

配置:	Named
必須:	True
パイプラインからの値:	True
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-JsonFilePath

作成操作に指定された Json ファイルのパス

パラメーターのプロパティ

型:	String
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

CreateViaJsonFilePath

配置:	Named
必須:	True
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-JsonString

作成操作に指定された Json 文字列

パラメーターのプロパティ

型:	String
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

CreateViaJsonString

配置:	Named
必須:	True
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Name

作成するキー値スナップショットの名前。

パラメーターのプロパティ

型:	String
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

Create

配置:	Named
必須:	True
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

CreateViaJsonString

配置:	Named
必須:	True
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

CreateViaJsonFilePath

配置:	Named
必須:	True
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

CreateExpanded

配置:	Named
必須:	True
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-NoWait

コマンドを非同期的に実行する

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-RetentionPeriod

スナップショットが期限切れになるまでのアーカイブ状態を保持する時間 (秒単位)。 このプロパティは、スナップショットの作成時にのみ書き込み可能です。 指定しない場合、キーと値のリビジョンの既定の有効期間が使用されます。

パラメーターのプロパティ

型:	Int64
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

CreateExpanded

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

CreateViaIdentityExpanded

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-SyncToken

要求間のリアルタイムの整合性を保証するために使用されます。

パラメーターのプロパティ

型:	String
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Tag

スナップショットのタグ。

パラメーターのプロパティ

型:	Hashtable
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

CreateExpanded

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

CreateViaIdentityExpanded

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

パラメーターのプロパティ

型:	SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False
Aliases:	wi

パラメーター セット

(All)

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

CommonParameters

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、about_CommonParametersを参照してください。

入力

IAppConfigurationdataIdentity

ISnapshot

出力

ISnapshot