New-AzDataProtectionBackupConfigurationClientObject

新しいバックアップ構成オブジェクトを作成します

構文

Default (既定)

New-AzDataProtectionBackupConfigurationClientObject
    -DatasourceType <DatasourceTypes>
    [-AutoProtection]
    [-AutoProtectionExclusionRule <IBlobBackupAutoProtectionRule[]>]
    [-BackupHookReference <NamespacedNameResource[]>]
    [-ExcludedNamespace <String[]>]
    [-ExcludedResourceType <String[]>]
    [-IncludeAllContainer]
    [-IncludeClusterScopeResource <Boolean?>]
    [-IncludedNamespace <String[]>]
    [-IncludedResourceType <String[]>]
    [-LabelSelector <String[]>]
    [-SnapshotVolume <Boolean?>]
    [-StorageAccountName <String>]
    [-StorageAccountResourceGroupName <String>]
    [-VaultedBackupContainer <String[]>]
    [<CommonParameters>]

説明

新しいバックアップ構成オブジェクトを作成します

例 1: AzureKubernetesService を使用して保護を構成するための BackupConfiguration を作成する

$backupConfig = New-AzDataProtectionBackupConfigurationClientObject -SnapshotVolume $true -IncludeClusterScopeResource $true -DatasourceType AzureKubernetesService -LabelSelector "key=val","foo=bar" -ExcludedNamespace "excludeNS1","excludeNS2" -BackupHookReference @(@{name='bkphookname';namespace='default'},@{name='bkphookname1';namespace='hrweb'})
ObjectType                                  ExcludedNamespace        ExcludedResourceType IncludeClusterScopeResource IncludedNamespace IncludedResourceType LabelSelector      SnapshotVolume
----------                                  -----------------        -------------------- --------------------------- ----------------- -------------------- -------------      --------------
KubernetesClusterBackupDatasourceParameters {excludeNS1, excludeNS2}                      True                                                               {key=val, foo=bar} True

このコマンドを使用して、Kubernetes クラスターのバックアップを構成するために使用されるバックアップ構成クライアント オブジェクトを作成できます。 BackupHookReferences は、バックアップの実行前と実行後に実行する必要がある BackupHook への参照の一覧です。

例 2: BackupConfiguration を作成して、AzureBlob のコンテナー化されたバックアップを構成するための特定のコンテナーを選択します。

$storageAccount = Get-AzStorageAccount -ResourceGroupName $resourceGroupName -Name $storageAccountName
$containers=Get-AzStorageContainer -Context $storageAccount.Context
$backupConfig = New-AzDataProtectionBackupConfigurationClientObject -DatasourceType AzureBlob -VaultedBackupContainer $containers.Name[1,3,4]
ObjectType                     ContainersList
----------                     --------------
BlobBackupDatasourceParameters {conabb, conwxy, conzzz}

このコマンドを使用すると、コンテナー化された BLOB バックアップ コンテナーのバックアップを構成するために使用されるバックアップ構成クライアント オブジェクトを作成できます。

例 3: AzureBlob の自動保護を有効にする BackupConfiguration を作成します。

$backupConfig = New-AzDataProtectionBackupConfigurationClientObject -DatasourceType AzureBlob -AutoProtection
ObjectType                                          AutoProtectionSettingEnabled AutoProtectionSettingObjectType
----------                                          --------------------------- ------------------------------
BlobBackupDatasourceParametersForAutoProtection      True                        BlobBackupRuleBasedAutoProtectionSettings

このコマンドは、Azure BLOB に対して自動保護が有効になっているバックアップ構成クライアント オブジェクトを作成します。 自動保護を有効にすると、手動で構成しなくても、新しいコンテナーが自動的に保護されます。

例 4: 除外規則を使用して AzureDataLakeStorage の自動保護を有効にする BackupConfiguration を作成する。

$rule = [Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Models.Api20260301.BlobBackupAutoProtectionRule]::new()
$rule.ObjectType = "BlobBackupAutoProtectionRule"
$rule.Pattern = "logs-"
$backupConfig = New-AzDataProtectionBackupConfigurationClientObject -DatasourceType AzureDataLakeStorage -AutoProtection -AutoProtectionExclusionRule @($rule)
ObjectType                                              AutoProtectionSettingEnabled AutoProtectionSettingObjectType
----------                                              --------------------------- ------------------------------
AdlsBlobBackupDatasourceParametersForAutoProtection      True                        BlobBackupRuleBasedAutoProtectionSettings

このコマンドは、Azure Data Lake Storageの自動保護が有効になっているバックアップ構成クライアント オブジェクトを作成します。 除外規則では、名前がプレフィックス "logs-" と一致するコンテナーが自動保護から除外されます。

パラメーター

-AutoProtection

自動保護を有効にするスイッチ パラメーター。 有効にすると、ルールに一致する新しいコンテナーが自動的に保護されます。 DatasourceType AzureBlob または AzureDataLakeStorage には、このパラメーターを使用します。

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

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

パラメーター セット

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

-AutoProtectionExclusionRule

自動保護の除外規則の一覧。 各ルールは、除外するコンテナー名プレフィックス パターンを指定する BlobBackupAutoProtectionRule オブジェクトです。 このパラメーターを -AutoProtection と共に使用します。 構築するには、AUTOPROTECTIONEXCLUSIONRULE プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

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

型:

IBlobBackupAutoProtectionRule[]

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

パラメーター セット

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

-BackupHookReference

バックアップ中に実行されるフック参照。 構築するには、BACKUPHOOKREFERENCE プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

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

型:

NamespacedNameResource[]

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

パラメーター セット

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

-DatasourceType

データソースの種類

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

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

パラメーター セット

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

-ExcludedNamespace

バックアップから除外する名前空間の一覧

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

型:

String[]

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

パラメーター セット

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

-ExcludedResourceType

バックアップから除外するリソースの種類の一覧

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

型:

String[]

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

パラメーター セット

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

-IncludeAllContainer

パラメーターを切り替えて、VaultStore 内にバックアップするすべてのコンテナーを含めます。 DatasourceType AzureBlob には、このパラメーターを使用します。

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

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

パラメーター セット

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

-IncludeClusterScopeResource

バックアップにクラスター スコープ リソースを含めるかどうかを決定するブール型パラメーター。 既定では、これは true と見なされます。

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

型:

Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=8.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

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

パラメーター セット

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

-IncludedNamespace

バックアップに含める名前空間の一覧

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

型:

String[]

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

パラメーター セット

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

-IncludedResourceType

バックアップに含めるリソースの種類の一覧

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

型:

String[]

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

パラメーター セット

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

-LabelSelector

バックアップ用の内部フィルター処理用のラベルの一覧

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

型:

String[]

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

パラメーター セット

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

-SnapshotVolume

バックアップにスナップショット ボリュームを含めるかどうかを決定するブール型パラメーター。 既定では、これは true と見なされます。

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

型:

Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=8.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

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

パラメーター セット

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

-StorageAccountName

データソースが存在するストレージ アカウント。 DatasourceType AzureBlob には、このパラメーターを使用します。

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

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

パラメーター セット

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

-StorageAccountResourceGroupName

データソースが存在するストレージ アカウントのリソース グループ名。 DatasourceType AzureBlob には、このパラメーターを使用します。

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

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

パラメーター セット

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

-VaultedBackupContainer

VaultStore 内でバックアップするコンテナーの一覧。 DatasourceType AzureBlob には、このパラメーターを使用します。

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

型:

String[]

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

パラメーター セット

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

CommonParameters

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

出力

PSObject