Set-AzRecoveryServicesVaultProperty

  • Referensi
Modul:
Az.RecoveryServices

Memperbarui properti Vault.

Sintaks

Set-AzRecoveryServicesVaultProperty
   [-SoftDeleteFeatureState <String>]
   [-DisableHybridBackupSecurityFeature <Boolean>]
   [-VaultId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-Token <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzRecoveryServicesVaultProperty
   [-VaultId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   -EncryptionKeyId <String>
   [-KeyVaultSubscriptionId <String>]
   [-InfrastructureEncryption]
   [-UseSystemAssignedIdentity <Boolean>]
   [-UserAssignedIdentity <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Deskripsi

Cmdlet Set-AzRecoveryServicesVaultProperty memperbarui properti vault layanan Pemulihan. Cmdlet ini dapat digunakan untuk Mengaktifkan/Menonaktifkan/SelaluON penghapusan sementara atau mengatur enkripsi CMK untuk vault dengan dua set parameter yang berbeda. Properti SoftDeleteFeatureState dari vault hanya dapat dinonaktifkan jika tidak ada kontainer terdaftar di vault. InfrastructurEncryption hanya dapat diatur pertama kali pengguna memperbarui vault CMK.

Contoh

Contoh 1: Memperbarui SoftDeleteFeatureState dari vault

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "rgName" -Name "vaultName"
$props = Set-AzRecoveryServicesVaultProperty -VaultId $vault.Id -SoftDeleteFeatureState Enable

Perintah pertama mendapatkan objek Vault lalu menyimpannya dalam variabel $vault. Perintah kedua Memperbarui properti SoftDeleteFeatureState dari vault ke status "Diaktifkan". Nilai yang diizinkan untuk SoftDeleteFeatureState adalah Nonaktifkan, Aktifkan, AlwaysON.

Contoh 2: Memperbarui enkripsi CMK vault untuk menggunakan SystemAssigned MSIdentity

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "rgName" -Name "vaultName"
$keyVault = Get-AzKeyVault -VaultName "keyVaultName" -ResourceGroupName "RGName" 
$key = Get-AzKeyVaultKey -VaultName "keyVaultName" -Name "keyName" 
Set-AzRecoveryServicesVaultProperty -EncryptionKeyId $key.ID -InfrastructureEncryption -VaultId $vault.ID -UseSystemAssignedIdentity $true

Cmdlet pertama mendapatkan RSVault untuk memperbarui properti enkripsi. Cmdlet kedua mendapatkan brankas kunci azure. Cmdlet ketiga mendapatkan kunci dari brankas kunci. Cmdlet keempat memperbarui kunci enkripsi yang dikelola pelanggan dalam RSVault untuk diakses melalui identitas SystemAssigned. Gunakan param -InfrastructureEncryption untuk mengaktifkan enkripsi infrastruktur untuk pembaruan pertama kali.

Contoh 3: Memperbarui enkripsi CMK vault untuk menggunakan userAssigned MSIdentity

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "rgName" -Name "vaultName"
$keyVault = Get-AzKeyVault -VaultName "keyVaultName" -ResourceGroupName "RGName" 
$key = Get-AzKeyVaultKey -VaultName "keyVaultName" -Name "keyName" 
Set-AzRecoveryServicesVaultProperty -EncryptionKeyId $key.ID -VaultId $vault.ID -UseSystemAssignedIdentity $false -UserAssignedIdentity $vault.Identity.UserAssignedIdentities.Keys[0]

Cmdlet pertama mendapatkan RSVault untuk memperbarui properti enkripsi. Cmdlet kedua mendapatkan brankas kunci azure. Cmdlet ketiga mendapatkan kunci dari brankas kunci. Cmdlet keempat memperbarui kunci enkripsi yang dikelola pelanggan dalam RSVault untuk diakses melalui identitas UserAssigned.

Contoh 4: Memperbarui HybridBackupSecurityFeature dari vault

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "rgName" -Name "vaultName"
$prop = Set-AzRecoveryServicesVaultProperty -VaultId $vault.Id -DisableHybridBackupSecurityFeature $false

Perintah pertama mendapatkan objek Vault lalu menyimpannya dalam variabel $vault. Perintah kedua menonaktifkan HybridBackupSecurityFeature dari vault, atur $true untuk mengaktifkannya lagi.

Parameter

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableHybridBackupSecurityFeature

Bendera opsional ($true/$false) untuk menonaktifkan/mengaktifkan pengaturan keamanan untuk pencadangan hibrid terhadap penghapusan yang tidak disengaja dan menambahkan lapisan autentikasi tambahan untuk operasi penting. Sediakan $false untuk mengaktifkan keamanan.

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EncryptionKeyId

KeyId dari kunci enkripsi yang akan digunakan untuk CMK.

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

-InfrastructureEncryption

Mengaktifkan enkripsi infrastruktur pada vault ini. Enkripsi infrastruktur harus diaktifkan saat mengonfigurasi enkripsi.

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

-KeyVaultSubscriptionId

Id Langganan Key Vault.

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

-SoftDeleteFeatureState

SoftDeleteFeatureState dari Vault Layanan Pemulihan. Nilai yang diizinkan adalah Nonaktifkan, Aktifkan, AlwaysON.

Type:String
Accepted values:Enable, Disable, AlwaysON
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Token

Token akses tambahan untuk mengautentikasi operasi penting ke langganan resource guard

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

-UserAssignedIdentity

ID ARM dari UserAssigned Identity yang akan digunakan untuk enkripsi CMK. Berikan parameter ini jika UseSystemAssignedIdentity $false.

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

-UseSystemAssignedIdentity

Bendera Boolean untuk menunjukkan apakah SystemAssigned Identity akan digunakan untuk enkripsi CMK. Vaules yang Diterima: $true, $false

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

-VaultId

ID ARM dari Vault Layanan Pemulihan.

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

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

String

Microsoft.Azure.Commands.RecoveryServices.Backup.Cmdlets.Models.VaultSoftDeleteFeatureState

Output

BackupResourceVaultConfigResource