Remove-AzSqlDatabaseLongTermRetentionBackupImmutability
Remove uma política de imutabilidade baseada no tempo desbloqueada para um backup LTR.
Sintaxe
RemoveBackupImmutabilityDefault (Predefinição)
Remove-AzSqlDatabaseLongTermRetentionBackupImmutability
[-Location] <String>
[-ServerName] <String>
[-DatabaseName] <String>
[-BackupName] <String>
[-ResourceGroupName <String>]
[-Force]
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-AzSqlDatabaseLongTermRetentionBackupImmutability
[-InputObject] <AzureSqlDatabaseLongTermRetentionBackupModel>
[-Force]
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RemoveBackupImmutabilityByResourceId
Remove-AzSqlDatabaseLongTermRetentionBackupImmutability
[-ResourceId] <String>
[-Force]
[-PassThru]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Remove-AzSqlDatabaseLongTermRetentionBackupImmutability remove permanentemente uma política de imutabilidade baseada no tempo desbloqueada para o backup.
Uma vez removido, o backup poderá ser excluído manualmente. Não é possível voltar a adicionar a imutabilidade baseada no tempo depois de removida (no entanto, uma retenção legal sempre pode ser aplicada).
Exemplos
Exemplo 1: Remova a política de imutabilidade baseada em tempo para um único backup.
Remove-AzSqlDatabaseLongTermRetentionBackupImmutability -Location northeurope -ServerName server01 -DatabaseName testdb2 -BackupName "601061b7-d10b-46e0-bf77-a2bfb16a6add;131655666550000000" -PassThru
BackupExpirationTime : 8/5/2025 8:23:33 PM
BackupName : 601061b7-d10b-46e0-bf77-a2bfb16a6add;131655666550000000
BackupTime : 7/29/2025 8:23:33 PM
DatabaseName : testdb2
DatabaseDeletionTime :
Location : northeurope
ResourceId : /subscriptions/b75889fa-6661-44e0-a844-cd96ec938991/resourceGroups/resourcegroup01/providers/Microsoft.Sql/locations/northeurope/longTermRetentionServers/server01/longTermRetentionDatabases/testdb2/longTermRetentionBackups/601061b7-d10b-46e0-bf77-a2bfb16a6add;131655666550000000
ServerName : server01
ServerCreateTime : 7/29/2025 7:28:46 PM
ResourceGroupName : resourcegroup01
BackupStorageRedundancy : Geo
TimeBasedImmutability : Disabled
TimeBasedImmutabilityMode : Unlocked
LegalHoldImmutability : Disabled
Isso remove a política de imutabilidade baseada em tempo para o backup "601061b7-d10b-46e0-bf77-a2bfb16a6add; 131655666550000000".
Observe que um pré-requisito para essa operação é que o backup tenha TimeBasedImmutability definido como "Enabled" e TimeBasedImmutabilityMode definido como "Unlocked".
Parâmetros
-AsJob
Executar cmdlet em segundo plano
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-BackupName
O nome do backup.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
RemoveBackupImmutabilityDefault
Position: 3 Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: Cf.
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-DatabaseName
O nome do Banco de Dados SQL do Azure do qual o backup é originário.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
RemoveBackupImmutabilityDefault
Position: 2 Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.
Propriedades dos parâmetros
Tipo: IAzureContextContainer
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: AzContext, AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Force
Ignorar mensagem de confirmação para executar a ação
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
O backup de retenção de longo prazo do banco de dados para o qual remover a imutabilidade baseada no tempo.
RemoveBackupImmutabilityByInputObject
Position: 0 Obrigatório: True Valor do pipeline: True Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Location
O local do servidor de origem dos backups.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
RemoveBackupImmutabilityDefault
Position: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-PassThru
Se o modelo deve ser gerado no final da execução
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-ResourceGroupName
O nome do grupo de recursos.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
RemoveBackupImmutabilityDefault
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-ResourceId
A ID do recurso do backup de retenção de longo prazo do banco de dados para o qual remover a imutabilidade baseada no tempo
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
RemoveBackupImmutabilityByResourceId
Position: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-ServerName
O nome do SQL Server do Azure sob o qual o backup está.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
RemoveBackupImmutabilityDefault
Position: 1 Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado.
O cmdlet não é executado.
Propriedades dos parâmetros
Tipo: SwitchParameter
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: Wi
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas
