Dela via


Set-AzRecoveryServicesVaultProperty

Uppdaterar egenskaperna för ett valv.

Syntax

AzureRSVaultSoftDeleteParameterSet (Standard)

Set-AzRecoveryServicesVaultProperty
    [-SoftDeleteFeatureState <String>]
    [-SoftDeleteRetentionPeriodInDays <Int32>]
    [-DisableHybridBackupSecurityFeature <Boolean>]
    [-VaultId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-Token <String>]
    [-SecureToken <SecureString>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AzureRSVaultCMKParameterSet

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

Description

Cmdleten Set-AzRecoveryServicesVaultProperty uppdaterar egenskaperna för ett Recovery Services-valv. Den här cmdleten kan användas för att aktivera/inaktivera/AlwaysON mjuk borttagning eller ange CMK-kryptering för ett valv med två olika parameteruppsättningar. Egenskapen SoftDeleteFeatureState för ett valv kan endast inaktiveras om det inte finns några registrerade containrar i valvet. InfrastrukturKryptering kan bara ställas in första gången en användare uppdaterar CMK-valvet.

Exempel

Exempel 1: Uppdatera SoftDeleteFeatureState för ett valv

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

Det första kommandot hämtar ett Valvobjekt och lagrar det sedan i variabeln $vault. Det andra kommandot uppdaterar egenskapen SoftDeleteFeatureState för valvet till tillståndet "Aktiverad". Tillåtna värden för SoftDeleteFeatureState är Inaktivera, Aktivera, AlwaysON.

Exempel 2: Uppdatera CMK-kryptering för ett valv för att använda 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

Första cmdleten hämtar RSVault för att uppdatera krypteringsegenskaper. Den andra cmdleten hämtar Azure Key Vault. Den tredje cmdleten hämtar nyckeln från nyckelvalvet. Den fjärde cmdleten uppdaterar den kundhanterade krypteringsnyckeln i RSVault som ska nås via SystemAssigned-identitet. Använd -InfrastructureEncryption param för att aktivera infrastrukturkryptering för första gången uppdateringen.

Exempel 3: Uppdatera CMK-kryptering för ett valv för att använda 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]

Första cmdleten hämtar RSVault för att uppdatera krypteringsegenskaper. Den andra cmdleten hämtar Azure Key Vault. Den tredje cmdleten hämtar nyckeln från nyckelvalvet. Den fjärde cmdleten uppdaterar den kundhanterade krypteringsnyckeln i RSVault så att den nås via användartilldelad identitet.

Exempel 4: Uppdatera HybridBackupSecurityFeature för ett valv

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

Det första kommandot hämtar ett Valvobjekt och lagrar det sedan i variabeln $vault. Det andra kommandot inaktiverar HybridBackupSecurityFeature för valvet och anger $true för att aktivera det igen.

Exempel 5: Uppdatera SoftDeleteFeatureState och HybridBackupSecurityFeature till AlwaysON

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

Det första kommandot hämtar ett Valvobjekt och lagrar det sedan i variabeln $vault. Det andra kommandot anger SoftDeleteFeatureState för valvet till "AlwaysON", som också anger HybridBackupSecurityFeature till AlwaysON. Dessutom används parametern SoftDeleteRetentionPeriodInDays för att ange kvarhållningsperioden för mjuk borttagning till 16 dagar.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DisableHybridBackupSecurityFeature

Valfri flagga ($true/$false) för att inaktivera/aktivera säkerhetsinställningar för hybridsäkerhetskopior mot oavsiktliga borttagningar och lägga till ytterligare autentiseringslager för kritiska åtgärder. Ange $false för att aktivera säkerheten.

Parameteregenskaper

Typ:

Nullable<T>[Boolean]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

AzureRSVaultSoftDeleteParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-EncryptionKeyId

KeyId för krypteringsnyckeln som ska användas för CMK.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

AzureRSVaultCMKParameterSet
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-InfrastructureEncryption

Aktiverar infrastrukturkryptering i det här valvet. Infrastrukturkryptering måste aktiveras när kryptering konfigureras.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

AzureRSVaultCMKParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-KeyVaultSubscriptionId

Prenumerations-ID för Key Vault.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

AzureRSVaultCMKParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-SecureToken

Parameter för att auktorisera åtgärder som skyddas av resursskydd mellan klientorganisationer. Använd kommandot (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxx"). Token för att hämta auktoriseringstoken för olika klientorganisationer

Parameteregenskaper

Typ:SecureString
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-SoftDeleteFeatureState

SoftDeleteFeatureState för Recovery Services-valvet. Tillåtna värden är Inaktivera, Aktivera, AlwaysON.

Parameteregenskaper

Typ:String
Standardvärde:None
Godkända värden:Enable, Disable, AlwaysON
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

AzureRSVaultSoftDeleteParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-SoftDeleteRetentionPeriodInDays

Anger kvarhållningsperioden för mjukt borttagna objekt i dagar.

Parameteregenskaper

Typ:

Nullable<T>[Int32]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

AzureRSVaultSoftDeleteParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Token

Extra åtkomsttoken för autentisering av kritisk åtgärd till resource guard-prenumeration

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-UserAssignedIdentity

ARM-ID för användartilldelad identitet som ska användas för CMK-kryptering. Ange den här parametern om UseSystemAssignedIdentity är $false.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

AzureRSVaultCMKParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-UseSystemAssignedIdentity

Boolesk flagga för att ange om SystemAssigned Identity ska användas för CMK-kryptering. Godkända värden: $true, $false

Parameteregenskaper

Typ:Boolean
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

AzureRSVaultCMKParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-VaultId

ARM-ID för Recovery Services-valvet.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-WhatIf

Visar vad som skulle hända om kommandot körs.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

String

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

Utdata

BackupResourceVaultConfigResource