Freigeben über

Restore-AzKeyVaultSecret

  • Referenz
Modul:
Az.KeyVault

Erstellt einen Geheimschlüssel in einem Schlüsseltresor aus einem gesicherten Geheimschlüssel.

Syntax

Restore-AzKeyVaultSecret
       [-VaultName] <String>
       [-InputFile] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Restore-AzKeyVaultSecret
       [-Id] <String>
       [-InputFile] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Restore-AzKeyVaultSecret
       [-InputObject] <PSKeyVault>
       [-InputFile] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Restore-AzKeyVaultSecret
       [-ParentResourceId] <String>
       [-InputFile] <String>
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Beschreibung

Das Cmdlet Restore-AzKeyVaultSecret erstellt einen geheimen Schlüssel im angegebenen Schlüsseltresor. Dieser geheime Schlüssel ist ein Replikat des gesicherten Geheimschlüssels in der Eingabedatei und hat denselben Namen wie der ursprüngliche geheime Schlüssel. Wenn der Schlüsseltresor bereits über einen geheimen Schlüssel mit demselben Namen verfügt, schlägt dieses Cmdlet fehl, anstatt den ursprünglichen geheimen Schlüssel zu überschreiben. Wenn die Sicherung mehrere Versionen eines geheimen Schlüssels enthält, werden alle Versionen wiederhergestellt. Der Schlüsseltresor, in den Sie den Geheimschlüssel wiederherstellen, kann sich von dem Schlüsseltresor unterscheiden, von dem Sie den geheimen Schlüssel gesichert haben. Der Schlüsseltresor muss jedoch dasselbe Abonnement verwenden und sich in einer Azure-Region in derselben Geografie befinden (z. B. Nordamerika). Informationen zur Zuordnung von Azure-Regionen zu Regionen finden Sie im Microsoft Azure Trust Center (https://azure.microsoft.com/support/trust-center/).

Beispiele

Beispiel 1: Wiederherstellen eines gesicherten geheimen Schlüssels

Restore-AzKeyVaultSecret -VaultName 'contoso' -InputFile "C:\Backup.blob"

Vault Name   : contoso
Name         : secret1
Version      : 7128133570f84a71b48d7d0550deb74c
Id           : https://contoso.vault.azure.net:443/secrets/secret1/7128133570f84a71b48d7d0550deb74c
Enabled      : True
Expires      : 4/6/2018 3:59:43 PM
Not Before   :
Created      : 4/5/2018 11:46:28 PM
Updated      : 4/6/2018 11:30:17 PM
Content Type :
Tags         :

Mit diesem Befehl wird ein geheimer Schlüssel, einschließlich aller Versionen, aus der Sicherungsdatei "Backup.blob" in den Schlüsseltresor namens "contoso" wiederhergestellt.

Beispiel 2: Wiederherstellen eines gesicherten geheimen Schlüssels (mit URI)

Restore-AzKeyVaultSecret -Id "https://contoso.vault.azure.net:443/secrets/" -InputFile "C:\Backup.blob"

Vault Name   : contoso
Name         : secret1
Version      : 7128133570f84a71b48d7d0550deb74c
Id           : https://contoso.vault.azure.net:443/secrets/secret1/7128133570f84a71b48d7d0550deb74c
Enabled      : True
Expires      : 4/6/2018 3:59:43 PM
Not Before   :
Created      : 4/5/2018 11:46:28 PM
Updated      : 4/6/2018 11:30:17 PM
Content Type :
Tags         :

Mit diesem Befehl wird ein geheimer Schlüssel, einschließlich aller Versionen, aus der Sicherungsdatei "Backup.blob" in den Schlüsseltresor namens "contoso" wiederhergestellt.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

Der URI des Schlüsselschlüsselschlüssels. Stellen Sie sicher, dass es dem Format folgt: https://<vault-name>.vault.azure.net/secrets/<secret-name>/<version>

Typ:String
Aliase:SecretId
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputFile

Gibt die Eingabedatei an, die die Sicherung des geheimen Schlüssels zum Wiederherstellen enthält.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

KeyVault-Objekt

Typ:PSKeyVault
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ParentResourceId

KeyVault-Ressourcen-ID

Typ:String
Aliase:ResourceId
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VaultName

Gibt den Namen des Schlüsseltresors an, in dem der geheime Schlüssel wiederhergestellt werden soll.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Ausgaben