Partager via


New-SqlCngColumnMasterKeySettings

Crée un objet SqlColumnMasterKeySettings décrivant une clé asymétrique stockée dans un magasin de clés prenant en charge l’API CNG.

Syntaxe

New-SqlCngColumnMasterKeySettings
   [-CngProviderName] <String>
   [-KeyName] <String>
   [-ProgressAction <ActionPreference>]
   [<CommonParameters>]

Description

L’applet de commande New-SqlCngColumnMasterKeySettings crée un objet SqlColumnMasterKeySettings. L’objet SqlColumnMasterKeySettings fait référence à une clé, stockée dans un magasin de clés prenant en charge l’API CNG (Cryptography Next Generation). L’objet SqlColumnMasterKeySettings a deux propriétés : KeyStoreProviderName et KeyPath. Cette applet de commande définit la propriété KeyStoreProviderName pour contenir le nom du fournisseur de magasin de clés principale de colonne pour CNG, puis génère et définit la valeur de la propriété KeyPath pour référencer la clé spécifiée.

Exemples

Exemple 1 : Créer un objet SqlColumnMasterKeySettings

PS C:\> $CMKSettings = New-SqlCngColumnMasterKeySettings -CngProviderName "Microsoft Software Key Storage Provider" -KeyName "AlwaysEncryptedKey"

Cette commande crée un objet SqlColumnMasterKeySettings référençant une clé dans un magasin de clés encapsulé par un fournisseur CNG nommé Fournisseur de stockage de clés logicielles Microsoft. La commande stocke ensuite le résultat de l’opération dans la variable nommée $CMKSettings.

Paramètres

-CngProviderName

Spécifie le nom du fournisseur CNG pour le magasin de clés.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-KeyName

Spécifie le nom de la clé dans le magasin de clés.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ProgressAction

Détermine comment PowerShell répond aux mises à jour de progression générées par un script, une applet de commande ou un fournisseur, telles que les barres de progression générées par l’applet de commande Write-Progress. L’applet de commande Write-Progress crée des barres de progression qui affichent l’état d’une commande.

Type:ActionPreference
Alias:proga
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Sorties

SqlColumnMasterKeySettings