Backup-AzureKeyVaultCertificate
Maakt een back-up van een certificaat in een sleutelkluis.
Waarschuwing
De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.
Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.
Syntax
Backup-AzureKeyVaultCertificate
[-VaultName] <String>
[-Name] <String>
[[-OutputFile] <String>]
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Backup-AzureKeyVaultCertificate
[-InputObject] <PSKeyVaultCertificateIdentityItem>
[[-OutputFile] <String>]
[-Force]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
De cmdlet Backup-AzureKeyVaultCertificate maakt een back-up van een opgegeven certificaat in een sleutelkluis door het te downloaden en op te slaan in een bestand. Als het certificaat meerdere versies heeft, worden alle versies ervan opgenomen in de back-up. Omdat de gedownloade inhoud is versleuteld, kan deze niet worden gebruikt buiten Azure Key Vault. U kunt een back-upcertificaat herstellen naar een sleutelkluis in het abonnement waarvan een back-up is gemaakt, zolang de kluis zich in dezelfde Azure-geografie bevindt. Veelvoorkomende redenen voor het gebruik van deze cmdlet zijn:
U wilt een offlinekopie van het certificaat behouden voor het geval u het origineel per ongeluk uit de kluis verwijdert.
U hebt een certificaat gemaakt met Key Vault en wilt het object nu klonen in een andere Azure-regio, zodat u het kunt gebruiken vanuit alle exemplaren van uw gedistribueerde toepassing. Gebruik de cmdlet Backup-AzureKeyVaultCertificate om het certificaat op te halen in versleutelde indeling en gebruik vervolgens de cmdlet Restore-AzureKeyVaultCertificate en geef een sleutelkluis op in de tweede regio.
Voorbeelden
Voorbeeld 1: Een back-up maken van een certificaat met een automatisch gegenereerde bestandsnaam
PS C:\Users\username\> Backup-AzureKeyVaultCertificate -VaultName 'mykeyvault' -Name 'mycert'
C:\Users\username\mykeyvault-mycert-1527029447.01191
Met deze opdracht wordt het certificaat met de naam MyCert opgehaald uit de sleutelkluis met de naam MyKeyVault en wordt een back-up van dat certificaat opgeslagen in een bestand dat automatisch voor u wordt genoemd en wordt de bestandsnaam weergegeven.
Voorbeeld 2: Een back-up maken van een certificaat naar een opgegeven bestandsnaam
PS C:\> Backup-AzureKeyVaultKey -VaultName 'MyKeyVault' -Name 'MyCert' -OutputFile 'C:\Backup.blob'
C:\Backup.blob
Met deze opdracht wordt het certificaat met de naam MyCert opgehaald uit de sleutelkluis met de naam MyKeyVault en wordt een back-up van dat certificaat opgeslagen in een bestand met de naam Backup.blob.
Voorbeeld 3: Maak een back-up van een eerder opgehaald certificaat naar een opgegeven bestandsnaam, waarbij het doelbestand wordt overschreven zonder dat u hierom wordt gevraagd.
PS C:\> $cert = Get-AzureKeyVaultCertificate -VaultName 'MyKeyVault' -Name 'MyCert'
PS C:\> Backup-AzureKeyVaultCertificate -Certificate $cert -OutputFile 'C:\Backup.blob' -Force
C:\Backup.blob
Met deze opdracht maakt u een back-up van het certificaat met de naam $cert. Naam in de kluis met de naam $cert. VaultName naar een bestand met de naam Backup.blob, overschrijft het bestand op de achtergrond als het al bestaat.
Parameters
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Het opgegeven bestand overschrijven als het bestaat
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Geheim waarvan een back-up moet worden gemaakt, gepijplijnd vanuit de uitvoer van een ophaalaanroep.
Type: | PSKeyVaultCertificateIdentityItem |
Aliases: | Certificate |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Geheime naam. Cmdlet bouwt de FQDN van een geheim uit kluisnaam, momenteel geselecteerde omgeving en geheime naam.
Type: | String |
Aliases: | SecretName |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OutputFile
Uitvoerbestand. Het uitvoerbestand voor het opslaan van de back-up van het certificaat. Als dit niet is opgegeven, wordt er een standaardbestandsbestand gegenereerd.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VaultName
Kluisnaam. Cmdlet bouwt de FQDN van een kluis op basis van de naam en momenteel geselecteerde omgeving.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Invoerwaarden
PSKeyVaultCertificateIdentityItem
Parameters: InputObject (ByValue)