Backup-AzureKeyVaultKey
Biztonsági másolatot készít egy kulcstartóban lévő kulcsról.
Figyelmeztetés
Az AzureRM PowerShell-modul 2024. február 29-én hivatalosan elavult. Javasoljuk a felhasználóknak, hogy migráljanak az AzureRM-ből az Az PowerShell-modulba a folyamatos támogatás és frissítések biztosítása érdekében.
Bár az AzureRM-modul továbbra is működik, a továbbiakban nem tart fenn vagy nem támogatott, így a folyamatos használatot a felhasználó saját belátása szerint és kockázatára teheti. Az Az modulra való áttéréshez tekintse meg a migrálási erőforrásainkat.
Syntax
Backup-AzureKeyVaultKey
[-VaultName] <String>
[-Name] <String>
[[-OutputFile] <String>]
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Backup-AzureKeyVaultKey
[-InputObject] <PSKeyVaultKeyIdentityItem>
[[-OutputFile] <String>]
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
A Backup-AzureKeyVaultKey parancsmag letölti és egy fájlban tárolja a kulcstartóban lévő megadott kulcsokat. Ha a kulcsnak több verziója is van, a biztonsági másolat tartalmazza az összes verziót. Mivel a letöltött tartalom titkosítva van, nem használható az Azure Key Vaulton kívül. A biztonsági másolatban szereplő kulcsokat az előfizetés bármely kulcstartójára visszaállíthatja, amelyről biztonsági másolat készült. A parancsmag használatának tipikus okai a következők:
Meg szeretné buktatni a kulcs egy példányát, hogy legyen offline példánya, ha véletlenül törli a kulcsát a kulcstartóban.
A Key Vault használatával létrehozott egy kulcsot, és most egy másik Azure-régióba szeretné klónozni a kulcsot, hogy az az elosztott alkalmazás összes példányából használható legyen. A Backup-AzureKeyVaultKey parancsmaggal kérje le a kulcsot titkosított formátumban, majd használja a Restore-AzureKeyVaultKey parancsmagot, és adjon meg egy kulcstartót a második régióban.
Példák
1. példa: Kulcs biztonsági mentése automatikusan létrehozott fájlnévvel
PS C:\Users\username\> Backup-AzureKeyVaultKey -VaultName 'MyKeyVault' -Name 'MyKey'
C:\Users\username\mykeyvault-mykey-1527029447.01191
Ez a parancs lekéri a MyKey nevű kulcsot a MyKeyVault kulcstartóból, és a kulcs biztonsági másolatát egy automatikusan Elnevezett fájlba menti, és megjeleníti a fájl nevét.
2. példa: Kulcs biztonsági mentése egy megadott fájlnévre
PS C:\> Backup-AzureKeyVaultKey -VaultName 'MyKeyVault' -Name 'MyKey' -OutputFile 'C:\Backup.blob'
C:\Backup.blob
Ez a parancs lekéri a MyKey nevű kulcsot a MyKeyVault kulcstartóból, és a kulcs biztonsági másolatát egy Backup.blob nevű fájlba menti.
3. példa: Egy korábban lekért kulcs biztonsági mentése egy megadott fájlnévre, a célfájl felülírása kérés nélkül.
PS C:\> $key = Get-AzureKeyVaultKey -VaultName 'MyKeyVault' -Name 'MyKey'
PS C:\> Backup-AzureKeyVaultKey -Key $key -OutputFile 'C:\Backup.blob' -Force
C:\Backup.blob
Ez a parancs létrehoz egy biztonsági másolatot a $key nevű kulcsról. A tároló neve $key. VaultName egy Backup.blob nevű fájlhoz, amely csendben felülírja a fájlt, ha már létezik.
Paraméterek
-Confirm
Jóváhagyást kér a parancsmag futtatása előtt.
Típus: | SwitchParameter |
Aliasok: | cf |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-DefaultProfile
Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés
Típus: | IAzureContextContainer |
Aliasok: | AzureRmContext, AzureCredential |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Force
A megadott fájl felülírása, ha létezik
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-InputObject
Kulcsköteg biztonsági mentéshez, beállítva egy lekéréses hívás kimenetéből.
Típus: | PSKeyVaultKeyIdentityItem |
Aliasok: | Key |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Name
Megadja a biztonsági mentéshez tartozó kulcs nevét.
Típus: | String |
Aliasok: | KeyName |
Position: | 1 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-OutputFile
Azt a kimeneti fájlt adja meg, amelyben a biztonsági mentési blob tárolódik. Ha nem adja meg ezt a paramétert, ez a parancsmag létrehoz egy fájlnevet az Ön számára. Ha egy meglévő kimeneti fájl nevét adja meg, a művelet nem fejeződik be, és hibaüzenetet ad vissza, hogy a biztonsági mentési fájl már létezik.
Típus: | String |
Position: | 2 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-VaultName
Megadja annak a kulcstartónak a nevét, amely tartalmazza a biztonsági mentéshez szükséges kulcsot.
Típus: | String |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
Típus: | SwitchParameter |
Aliasok: | wi |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
Paraméterek: InputObject (ByValue)