Invoke-AzKeyVaultKeyOperation
Olyan műveleteket hajt végre, mint a "Titkosítás", a "Visszafejtés", a "Wrap" vagy a "Unwrap" egy kulcstartóban vagy felügyelt hsm-ben tárolt megadott kulccsal.
Syntax
ByVaultName (Alapértelmezett)
Invoke-AzKeyVaultKeyOperation
[-Name] <String>
[-VaultName] <String>
-Operation <String>
-Algorithm <String>
-ByteArrayValue <Byte[]>
[-Version <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByHsmName
Invoke-AzKeyVaultKeyOperation
[-HsmName] <String>
[-Name] <String>
-Operation <String>
-Algorithm <String>
-ByteArrayValue <Byte[]>
[-Version <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Invoke-AzKeyVaultKeyOperation
[-InputObject] <PSKeyVaultKeyIdentityItem>
-Operation <String>
-Algorithm <String>
-ByteArrayValue <Byte[]>
[-Version <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Invoke-AzKeyVaultKeyOperation parancsmag támogatja
Tetszőleges bájtsorozat titkosítása titkosítási kulccsal.
Titkosított adatok egyetlen blokkjának visszafejtése.
Szimmetrikus kulcs körbefuttatása megadott kulccsal.
Szimmetrikus kulcs kibontása a kulcs burkolásához eredetileg használt megadott kulccsal.
Példák
1. példa: A bájttömb titkosítása titkosítási kulccsal
$byteArray = [Byte[]]@(58, 219)
$encryptedData = Invoke-AzKeyVaultKeyOperation -Operation Encrypt -Algorithm RSA1_5 -VaultName test-kv -Name test-key -ByteArrayValue $byteArray
$encryptedData
KeyId : https://bez-kv.vault.azure.net/keys/bez-key/c96ce0fb18de446c9f4b911b686988af
RawResult : {21, 39, 82, 56…}
Algorithm : RSA1_5
A $byteArray a test-kv fájlban tárolt tesztkulcs használatával titkosítja.
2. példa: Bájttömb visszafejtése titkosítási kulccsal
$encryptedData = [pscustomobject]@{ RawResult = [byte[]]@(58,219) }
$decryptedData = Invoke-AzKeyVaultKeyOperation -Operation Decrypt -Algorithm RSA1_5 -VaultName test-kv -Name test-key -ByteArrayValue $encryptedData.RawResult
$decryptedData
KeyId : https://bez-kv.vault.azure.net/keys/bez-key/c96ce0fb18de446c9f4b911b686988af
RawResult : {58, 219}
Algorithm : RSA1_5
Visszafejtés $encryptedData.RawResult a test-kv fájlban tárolt tesztkulcs használatával. Ugyanaz $decryptedData.RawResult , mint az $byteArrayeredeti adatokkal.
3. példa: Egyszerű szöveg titkosítása titkosítási kulccsal
$plainText = "test"
$byteArray = [system.Text.Encoding]::UTF8.GetBytes($plainText)
$encryptedData = Invoke-AzKeyVaultKeyOperation -Operation Encrypt -Algorithm RSA1_5 -VaultName test-kv -Name test-key -ByteArrayValue $byteArray
$encryptedData
KeyId : https://test-kv.vault.azure.net/keys/test-key/bd8b77352a2443d4983bd70e9f660bc6
RawResult : {58, 219, 6, 236…}
Algorithm : RSA1_5
A "test" sztringet a test-kv fájlban tárolt tesztkulcs használatával titkosítja. Ez RawResult a titkosított eredmény bájttömb formátumban.
4. példa: Titkosított adatok visszafejtése egyszerű szöveggé
$decryptedData = Invoke-AzKeyVaultKeyOperation -Operation Decrypt -Algorithm RSA1_5 -VaultName test-kv -Name test-key -ByteArrayValue $encryptedData.RawResult
$plainText = [system.Text.Encoding]::UTF8.GetString($decryptedData.RawResult)
$plainText
test
A test-kv fájlban tárolt tesztkulcs használatával titkosított titkosított adatok visszafejtése. A RawResult visszafejtett eredmény bájttömb formátumban.
5. példa: Szimmetrikus kulcs körbefuttatása megadott kulccsal
$key = "ovQIlbB0DgWhZA7sgkPxbg9H-Ly-VlNGPSgGrrZvlIo"
$byteArray = [system.Text.Encoding]::UTF8.GetBytes($key)
$wrappedResult = Invoke-AzKeyVaultKeyOperation -Operation Wrap -Algorithm RSA1_5 -VaultName test-kv -Name test-key -ByteArrayValue $byteArray
$wrappedResult | Format-List
KeyId : https://test-kv.vault.azure.net/keys/test-key/375cdf20252043b79c8ca0c57b6c7679
RawResult : {58, 219, 6, 236…}
Algorithm : RSA1_5
Szimmetrikus kulcs körbefuttatása a test-kv fájlban tárolt tesztkulcs nevű kulccsal. A RawResult burkolt eredmény bájttömb formátumban van.
6. példa: Szimmetrikus kulcs feloldása megadott kulccsal
$wrappedResult = [pscustomobject]@{ RawResult = [byte[]]@(58,219) }
$unwrappedResult = Invoke-AzKeyVaultKeyOperation -Operation Unwrap -Algorithm RSA1_5 -VaultName test-kv -Name test-key -ByteArrayValue $wrappedResult.RawResult
$key = [system.Text.Encoding]::UTF8.GetString($unwrappedResult.RawResult)
$key
ovQIlbB0DgWhZA7sgkPxbg9H-Ly-VlNGPSgGrrZvlIo
Szimmetrikus kulcs leválasztása a test-kv fájlban tárolt megadott kulcs tesztkulcsával. A RawResult le nem írt eredmény bájttömb formátumban van megírva.
Paraméterek
-Algorithm
Algoritmusazonosító
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Aliasok: EncryptionAlgorithm, WrapAlgorithm
Paraméterkészletek
(All)
Position: Named
Kötelező: True
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-ByteArrayValue
A bájttömb formátumban üzemeltetendő érték.
Paramétertulajdonságok
Típus: Byte [ ]
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
(All)
Position: Named
Kötelező: True
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-Confirm
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
Típus: SwitchParameter
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Aliasok: Cf
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-DefaultProfile
A Azure való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.
Paramétertulajdonságok
Típus: IAzureContextContainer
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Aliasok: AzContext, AzureRmContext, AzureCredential
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-HsmName
HSM-név.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
ByHsmName
Position: 0
Kötelező: True
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
Kulcsobjektum
Típus: PSKeyVaultKeyIdentityItem
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Aliasok: Key
ByKeyInputObject
Position: 0
Kötelező: True
Folyamatból származó érték: True
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-Name
Kulcsnév.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Aliasok: Kulcsnév
Paraméterkészletek
ByVaultName
Position: 1
Kötelező: True
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
ByHsmName
Position: 1
Kötelező: True
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-Operation
Algoritmusazonosító
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
(All)
Position: Named
Kötelező: True
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-VaultName
Tároló neve.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
ByVaultName
Position: 0
Kötelező: True
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-Version
Kulcsverzió.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Aliasok: Verziókulcs
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna.
A parancsmag nem fut.
Paramétertulajdonságok
Típus: SwitchParameter
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Aliasok: Wi
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters .
Kimenetek