Udostępnij za pośrednictwem


Restore-AzKeyVaultSecret

Tworzy wpis tajny w magazynie kluczy na podstawie wpisu tajnego kopii zapasowej.

Składnia

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>]

Opis

Polecenie cmdlet Restore-AzKeyVaultSecret tworzy wpis tajny w określonym magazynie kluczy. Ten wpis tajny jest repliką wpisu tajnego kopii zapasowej w pliku wejściowym i ma taką samą nazwę jak oryginalny wpis tajny. Jeśli magazyn kluczy ma już wpis tajny o tej samej nazwie, to polecenie cmdlet kończy się niepowodzeniem zamiast zastępowania oryginalnego wpisu tajnego. Jeśli kopia zapasowa zawiera wiele wersji wpisu tajnego, zostaną przywrócone wszystkie wersje. Magazyn kluczy, do którego przywracasz wpis tajny, może różnić się od magazynu kluczy, z którego utworzono kopię zapasową wpisu tajnego. Jednak magazyn kluczy musi używać tej samej subskrypcji i znajdować się w regionie świadczenia usługi Azure w tej samej lokalizacji geograficznej (na przykład w Ameryce Północnej). Aby uzyskać mapowanie regionów platformy Azure na lokalizacje geograficzne, zobacz Centrum zaufania platformy Microsoft Azure (https://azure.microsoft.com/support/trust-center/).

Przykłady

Przykład 1. Przywracanie kopii zapasowej wpisu tajnego

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         :

To polecenie przywraca wpis tajny, w tym wszystkie jego wersje, z pliku kopii zapasowej o nazwie Backup.blob do magazynu kluczy o nazwie contoso.

Przykład 2. Przywracanie kopii zapasowej wpisu tajnego (przy użyciu identyfikatora 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         :

To polecenie przywraca wpis tajny, w tym wszystkie jego wersje, z pliku kopii zapasowej o nazwie Backup.blob do magazynu kluczy o nazwie contoso.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Id

Identyfikator URI wpisu tajnego usługi KeyVault. Upewnij się, że jest on zgodny z formatem: https://<vault-name>.vault.azure.net/secrets/<secret-name>/<version>

Typ:String
Aliasy:SecretId
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InputFile

Określa plik wejściowy zawierający kopię zapasową wpisu tajnego do przywrócenia.

Typ:String
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InputObject

Obiekt KeyVault

Typ:PSKeyVault
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ParentResourceId

Identyfikator zasobu usługi KeyVault

Typ:String
Aliasy:ResourceId
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-VaultName

Określa nazwę magazynu kluczy, do którego ma być przywracany wpis tajny.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

PSKeyVault

String

Dane wyjściowe

PSKeyVaultSecret