New-SqlAzureKeyVaultColumnMasterKeySettings

New-SqlAzureKeyVaultColumnMasterKeySettings
    [-KeyUrl] <String>
    [[-Signature] <String>]
    [-KeyVaultAccessToken <String>]
    [-ManagedHsmAccessToken <String>]
    [-AllowEnclaveComputations]
    [<CommonParameters>]

Crée un objet SqlColumnMasterKeySettings décrivant une clé principale de colonne stockée dans un coffre de clés ou dans un HSM managé dans Azure Key Vault.

Si vous utilisez l’applet de commande pour signer les métadonnées de clé, vous devez spécifier un jeton d’authentification valide pour les coffres de clés ou les HSM managés. Vous pouvez également vous authentifier auprès d’Azure avec Add-SqlAzureAuthenticationContext avant d’appeler cette applet de commande.

Module requirements: version 21+ on PowerShell 5.1; version 22+ on PowerShell 7.x.

$CMKSettings = New-SqlAzureKeyVaultColumnMasterKeySettings -KeyUrl 'https://myvault.vault.contoso.net/keys/CMK/4c05f1a41b12488f9cba2ea964b6a700'

Cette commande crée un objet SqlColumnMasterKeySettings qui référence une clé dans Azure Key Vault et stocke le résultat dans la variable nommée $CMKSettings

# Obtain an access token for key vaults.
$keyVaultAccessToken = (Get-AzAccessToken -ResourceUrl https://vault.azure.net).Token

# Pass the token to the cmdlet. It will use the token to communicate with the key vault containing the column master key to sign the column master key metadata properties.
$cmkSettings = New-SqlAzureKeyVaultColumnMasterKeySettings -KeyUrl 'https://myvault.vault.azure.net/keys/CMK/4c05f1a41b12488f9cba2ea964b6a700' -AllowEnclaveComputations -keyVaultAccessToken $keyVaultAccessToken

Cette commande crée un objet SqlColumnMasterKeySettings qui référence une clé dans un coffre de clés et stocke le résultat dans la variable nommée $cmkSettings. La clé autorise les calculs d’enclave. Étant donné que le paramètre de signature n’est pas spécifié, l’applet de commande calcule automatiquement la signature et remplit la propriété Signature de l’objet SqlColumnMasterKeySettings.

Cet exemple illustre l’obtention d’un jeton d’authentification pour les coffres de clés dans Azure Key Vault et son passage à l’applet de commande.

# Note: actual signature truncated for brevity
$signature = "0x19BEB4F27F582F...89D5433CE9266C6F867334654BE12"
$cmkSettings = New-SqlAzureKeyVaultColumnMasterKeySettings -KeyUrl 'https://myvault.vault.contoso.net/keys/CMK/4c05f1a41b12488f9cba2ea964b6a700' -AllowEnclaveComputations -Signature $signature

Cette commande crée un objet SqlColumnMasterKeySettings qui référence une clé dans un coffre de clés et stocke le résultat dans la variable nommée $cmkSettings. La clé autorise les calculs d’enclave. La signature des propriétés de clé est spécifiée dans le paramètre Signature .

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.