@@ -9,7 +9,7 @@ tags: azure-resource-manager
9
9
ms.service : key-vault
10
10
ms.subservice : keys
11
11
ms.topic : tutorial
12
- ms.date : 11/21/2022
12
+ ms.date : 03/07/2023
13
13
ms.author : mbaldwin
14
14
15
15
---
@@ -104,11 +104,22 @@ Use the [az keyvault key create](/cli/azure/keyvault/key#az-keyvault-key-create)
104
104
``` azurecli
105
105
az keyvault key create --kty RSA-HSM --size 4096 --name KEKforBYOK --ops import --vault-name ContosoKeyVaultHSM
106
106
```
107
+ or in PowerShell
108
+
109
+ ``` azurepowershell
110
+ Add-AzKeyVaultKey -VaultName 'ContosoKeyVaultHSM' -Name 'KEKforBYOK' -Destination 'HSM' -Size 4096 -KeyOps 'import'
111
+ ```
112
+
107
113
or for Managed HSM
108
114
109
115
``` azurecli
110
116
az keyvault key create --kty RSA-HSM --size 4096 --name KEKforBYOK --ops import --hsm-name ContosoKeyVaultHSM
111
117
```
118
+ or in PowerShell for Managed HSM
119
+
120
+ ``` azurepowershell
121
+ Add-AzKeyVaultKey -HsmName 'ContosoKeyVaultHSM' -Name 'KEKforBYOK' -Destination 'HSM' -Size 4096 -KeyOps 'import'
122
+ ```
112
123
113
124
### Download the KEK public key
114
125
@@ -117,13 +128,24 @@ Use [az keyvault key download](/cli/azure/keyvault/key#az-keyvault-key-download)
117
128
``` azurecli
118
129
az keyvault key download --name KEKforBYOK --vault-name ContosoKeyVaultHSM --file KEKforBYOK.publickey.pem
119
130
```
131
+ or in PowerShell
132
+
133
+ ``` azurepowershell
134
+ Get-AzKeyVaultKey -VaultName 'ContosoKeyVaultHSM' -KeyName 'KEKforBYOK' -OutFile 'KEKforBYOK.publickey.pem'
135
+ ```
120
136
121
137
or for Managed HSM
122
138
123
139
``` azurecli
124
140
az keyvault key download --name KEKforBYOK --hsm-name ContosoKeyVaultHSM --file KEKforBYOK.publickey.pem
125
141
```
126
142
143
+ or in PowerShell for Managed HSM
144
+
145
+ ``` azurepowershell
146
+ Get-AzKeyVaultKey -HsmName 'ContosoKeyVaultHSM' -KeyName 'KEKforBYOK' -OutFile 'KEKforBYOK.publickey.pem'
147
+ ```
148
+
127
149
Transfer the KEKforBYOK.publickey.pem file to your offline computer. You will need this file in the next step.
128
150
129
151
### Generate and prepare your key for transfer
@@ -147,16 +169,33 @@ To import an RSA key use following command. Parameter --kty is optional and defa
147
169
az keyvault key import --vault-name ContosoKeyVaultHSM --name ContosoFirstHSMkey --byok-file KeyTransferPackage-ContosoFirstHSMkey.byok
148
170
```
149
171
172
+ or in PowerShell
173
+
174
+ ``` azurepowershell
175
+ Add-AzKeyVaultKey -VaultName 'ContosoKeyVaultHSM' -KeyName 'ContosoFirstHSMkey' -KeyFilePath 'KeyTransferPackage-ContosoFirstHSMkey.byok'
176
+ ```
177
+
150
178
or for Managed HSM
151
179
152
180
``` azurecli
153
181
az keyvault key import --hsm-name ContosoKeyVaultHSM --name ContosoFirstHSMkey --byok-file KeyTransferPackage-ContosoFirstHSMkey.byok
154
182
```
183
+ or in PowerShell for Managed HSM
184
+
185
+ ``` azurepowershell
186
+ Add-AzKeyVaultKey -HsmName 'ContosoKeyVaultHSM' -KeyName 'ContosoFirstHSMkey' -KeyFilePath 'KeyTransferPackage-ContosoFirstHSMkey.byok'
187
+ ```
155
188
156
189
To import an EC key, you must specify key type and the curve name.
157
190
158
191
``` azurecli
159
- az keyvault key import --vault-name ContosoKeyVaultHSM --name ContosoFirstHSMkey --byok-file --kty EC-HSM --curve-name "P-256" KeyTransferPackage-ContosoFirstHSMkey.byok
192
+ az keyvault key import --vault-name ContosoKeyVaultHSM --name ContosoFirstHSMkey --kty EC-HSM --curve-name "P-256" --byok-file KeyTransferPackage-ContosoFirstHSMkey.byok
193
+ ```
194
+
195
+ or in PowerShell
196
+
197
+ ``` azurepowershell
198
+ Add-AzKeyVaultKey -VaultName 'ContosoKeyVaultHSM' -KeyName 'ContosoFirstHSMkey' -KeyType EC -CurveName P-256 -KeyFilePath 'KeyTransferPackage-ContosoFirstHSMkey.byok'
160
199
```
161
200
162
201
or for Managed HSM
@@ -165,6 +204,12 @@ or for Managed HSM
165
204
az keyvault key import --hsm-name ContosoKeyVaultHSM --name ContosoFirstHSMkey --byok-file --kty EC-HSM --curve-name "P-256" KeyTransferPackage-ContosoFirstHSMkey.byok
166
205
```
167
206
207
+ or in PowerShell for Managed HSM
208
+
209
+ ``` azurepowershell
210
+ Add-AzKeyVaultKey -HsmName 'ContosoKeyVaultHSM' -KeyName 'ContosoFirstHSMkey' -KeyType EC -CurveName P-256 -KeyFilePath 'KeyTransferPackage-ContosoFirstHSMkey.byok'
211
+ ```
212
+
168
213
If the upload is successful, Azure CLI displays the properties of the imported key.
169
214
170
215
## Next steps
0 commit comments