Compartilhar via


Set-AzSqlInstanceTransparentDataEncryptionProtector

Define o protetor TDE (Transparent Data Encryption) para uma instância gerenciada de SQL.

Sintaxe

AzureSqlRmManagedInstanceTransparentDataEncryptionProtectorDefaultParameterSet (Default)

Set-AzSqlInstanceTransparentDataEncryptionProtector
    [-Type] <EncryptionProtectorType>
    [[-KeyId] <String>]
    [-ResourceGroupName] <String>
    [-InstanceName] <String>
    [-AutoRotationEnabled <Boolean>]
    [-Force]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AzureSqlRmManagedInstanceTransparentDataEncryptionProtectorInputObjectParameterSet

Set-AzSqlInstanceTransparentDataEncryptionProtector
    [-Type] <EncryptionProtectorType>
    [[-KeyId] <String>]
    [-Instance] <AzureSqlManagedInstanceModel>
    [-AutoRotationEnabled <Boolean>]
    [-Force]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AzureSqlRmManagedInstanceTransparentDataEncryptionProtectorResourceIdParameterSet

Set-AzSqlInstanceTransparentDataEncryptionProtector
    [-Type] <EncryptionProtectorType>
    [[-KeyId] <String>]
    [-InstanceResourceId] <String>
    [-AutoRotationEnabled <Boolean>]
    [-Force]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet Set-AzSqlInstanceTransparentDataEncryptionProtector define o protetor de TDE para uma instância gerenciada de SQL. A alteração do tipo protetor de TDE girará o protetor.

Exemplos

Exemplo 1: Definir o tipo de protetor TDE (Transparent Data Encryption) como ServiceManaged

Set-AzSqlInstanceTransparentDataEncryptionProtector -ResourceGroupName 'ContosoResourceGroup' -InstanceName 'ContosoManagedInstanceName' -Type ServiceManaged
ResourceGroupName              : ContosoResourceGroup
ManagedInstanceName            : ContosoManagedInstanceName
Type                           : ServiceManaged
ManagedInstanceKeyVaultKeyName : ServiceManaged
KeyId                          :

Esse comando atualiza o tipo de protetor de TDE de uma instância gerenciada para o Service Managed.

Exemplo 2: Definir o tipo protetor transparent data encryption para o Azure Key Vault

Set-AzSqlInstanceTransparentDataEncryptionProtector -ResourceGroupName 'ContosoResourceGroup' -InstanceName 'ContosoManagedInstanceName' -Type AzureKeyVault -KeyId 'https://contoso.vault.azure.net/keys/contosokey/01234567890123456789012345678901'
ResourceGroupName              : ContosoResourceGroup
ManagedInstanceName            : ContosoManagedInstanceName
Type                           : AzureKeyVault
ManagedInstanceKeyVaultKeyName : contoso_contosokey_01234567890123456789012345678901
KeyId                          : https://contoso.vault.azure.net/keys/contosokey/01234567890123456789012345678901

Esse comando atualiza a instância gerenciada especificada para usar a Chave do Key Vault da instância gerenciada com a ID 'https://contoso.vault.azure.net/keys/contosokey/01234567890123456789012345678901' como o protetor de TDE.

Exemplo 3: Definir o tipo de protetor transparent data encryption para o Azure Key Vault usando o objeto de instância gerenciada

$managedInstance = Get-AzSqlInstance -Name 'ContosoManagedInstanceName' -ResourceGroupName 'ContosoResourceGroup'
Set-AzSqlInstanceTransparentDataEncryptionProtector -Instance $managedInstance -Type AzureKeyVault -KeyId 'https://contoso.vault.azure.net/keys/contosokey/01234567890123456789012345678901'
ResourceGroupName              : ContosoResourceGroup
ManagedInstanceName            : ContosoManagedInstanceName
Type                           : AzureKeyVault
ManagedInstanceKeyVaultKeyName : contoso_contosokey_01234567890123456789012345678901
KeyId                          : https://contoso.vault.azure.net/keys/contosokey/01234567890123456789012345678901

Esse comando atualiza a instância gerenciada especificada para usar a Chave do Key Vault da instância gerenciada com a ID 'https://contoso.vault.azure.net/keys/contosokey/01234567890123456789012345678901' como o protetor de TDE.

Exemplo 4: Definir o tipo de protetor transparent data encryption para o Azure Key Vault usando a ID do recurso

$managedInstance = Get-AzSqlInstance -Name 'ContosoManagedInstanceName' -ResourceGroupName 'ContosoResourceGroup'
Set-AzSqlInstanceTransparentDataEncryptionProtector -InstanceResourceId $managedInstance.ResourceId -Type AzureKeyVault -KeyId 'https://contoso.vault.azure.net/keys/contosokey/01234567890123456789012345678901'
ResourceGroupName              : ContosoResourceGroup
ManagedInstanceName            : ContosoManagedInstanceName
Type                           : AzureKeyVault
ManagedInstanceKeyVaultKeyName : contoso_contosokey_01234567890123456789012345678901
KeyId                          : https://contoso.vault.azure.net/keys/contosokey/01234567890123456789012345678901

Esse comando atualiza a instância gerenciada especificada para usar a Chave do Key Vault da instância gerenciada com a ID 'https://contoso.vault.azure.net/keys/contosokey/01234567890123456789012345678901' como o protetor de TDE.

Exemplo 5: Definir o tipo de protetor transparent data encryption para o Azure Key Vault usando o piping

$managedInstance = Get-AzSqlInstance -Name 'ContosoManagedInstanceName' -ResourceGroupName 'ContosoResourceGroup'
$managedInstance | Set-AzSqlInstanceTransparentDataEncryptionProtector -Type AzureKeyVault -KeyId 'https://contoso.vault.azure.net/keys/contosokey/01234567890123456789012345678901'
ResourceGroupName              : ContosoResourceGroup
ManagedInstanceName            : ContosoManagedInstanceName
Type                           : AzureKeyVault
ManagedInstanceKeyVaultKeyName : contoso_contosokey_01234567890123456789012345678901
KeyId                          : https://contoso.vault.azure.net/keys/contosokey/01234567890123456789012345678901

Esse comando atualiza a instância gerenciada especificada para usar a Chave do Key Vault da instância gerenciada com a ID 'https://contoso.vault.azure.net/keys/contosokey/01234567890123456789012345678901' como o protetor de TDE.

Parâmetros

-AutoRotationEnabled

O status de aceitação de rotação automática da chave.

Propriedades do parâmetro

Tipo:

Nullable<T>[Boolean]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Force

Ignorar mensagem de confirmação para executar a ação

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Instance

O objeto de entrada da instância

Propriedades do parâmetro

Tipo:AzureSqlManagedInstanceModel
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:InputObject

Conjuntos de parâmetros

AzureSqlRmManagedInstanceTransparentDataEncryptionProtectorInputObjectParameterSet
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-InstanceName

O nome da instância

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AzureSqlRmManagedInstanceTransparentDataEncryptionProtectorDefaultParameterSet
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-InstanceResourceId

A ID do recurso da instância

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:ResourceId

Conjuntos de parâmetros

AzureSqlRmManagedInstanceTransparentDataEncryptionProtectorResourceIdParameterSet
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-KeyId

A KeyId do Azure Key Vault.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:2
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ResourceGroupName

O nome do grupo de recursos

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

AzureSqlRmManagedInstanceTransparentDataEncryptionProtectorDefaultParameterSet
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Type

O tipo protetor de criptografia de dados transparente do Banco de Dados Sql do Azure.

Propriedades do parâmetro

Tipo:EncryptionProtectorType
Valor padrão:None
Valores aceitos:AzureKeyVault, ServiceManaged
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Entradas

AzureSqlManagedInstanceModel

System.String

Saídas

AzureRmSqlManagedInstanceTransparentDataEncryptionProtectorModel