Add-AzVMSecret
Lägger till en hemlighet till en virtuell dator.
Anteckning
Det här är den tidigare versionen av vår dokumentation. Se den senaste versionen för uppdaterad information.
Syntax
Add-AzVMSecret
[-VM] <PSVirtualMachine>
[[-SourceVaultId] <String>]
[[-CertificateStore] <String>]
[[-CertificateUrl] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
Cmdleten Add-AzVMSecret lägger till en hemlighet till en virtuell dator. Med det här värdet kan du lägga till ett certifikat till den virtuella datorn. Hemligheten måste lagras i en Key Vault. Mer information om Key Vault finns i Vad är Azure Key Vault?. Mer information om cmdletarna finns i Azure Key Vault-cmdletar eller cmdletenSet-AzKeyVaultSecret.
Anteckning
Om du vill installera certifikat på en virtuell dator rekommenderar vi att du använder azure Key Vault-tillägget för virtuella datorer för Linux eller azure Key Vault-tillägget för virtuella datorer för Windows i stället för Add-AzVMSecret.
Exempel
Exempel: Lägga till en hemlighet på en virtuell dator med hjälp av Add-AzVMSecret
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
$Credential = Get-Credential
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Windows -ComputerName "Contoso26" -Credential $Credential
$SourceVaultId = "/subscriptions/46f8cea4-2de6-4179-8ab1-365da4211af4/resourceGroups/vault/providers/Microsoft.KeyVault/vaults/keyvault"
$CertificateStore01 = "My"
$CertificateUrl01 = "https://contosovault.vault.azure.net/secrets/514ceb769c984379a7e0230bdd703272"
$VirtualMachine = Add-AzVMSecret -VM $VirtualMachine -SourceVaultId $SourceVaultId -CertificateStore $CertificateStore01 -CertificateUrl $CertificateUrl01Det första kommandot skapar ett virtuellt datorobjekt och lagrar det sedan i variabeln $VirtualMachine.
Kommandot tilldelar ett namn och en storlek till den virtuella datorn.
Det andra kommandot skapar ett autentiseringsobjekt med hjälp av cmdleten Get-Credential och lagrar sedan resultatet i variabeln $Credential.
Kommandot uppmanar dig att ange ett användarnamn och lösenord.
För mer information ange Get-Help Get-Credential.
Det tredje kommandot använder cmdleten Set-AzVMOperatingSystem för att konfigurera den virtuella datorn som lagras i $VirtualMachine.
Det fjärde kommandot tilldelar ett källvalvs-ID till variabeln $SourceVaultId för senare användning.
Kommandot förutsätter att variabeln $SubscriptionId har ett lämpligt värde.
Det femte kommandot tilldelar ett värde till variabeln $CertificateStore 01 för senare användning.
Det sjätte kommandot tilldelar en URL för ett certifikatarkiv.
Det sjunde kommandot lägger till en hemlighet till den virtuella datorn som lagras i $VirtualMachine.
Parametern SourceVaultId anger Key Vault.
Kommandot anger namnet på certifikatarkivet och certifikatets URL.
Du kan köra Add-AzVMSecret upprepade gånger för att lägga till hemligheter för andra certifikat.
Parametrar
Anger namnet på ett certifikatarkiv på den virtuella dator som kör Windows-operativsystemet. Den här cmdleten lägger till certifikatet i det arkiv som den här parametern anger. Du kan bara ange den här parametern för virtuella datorer som kör Windows-operativsystemet.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Anger den URL som pekar på en Key Vault hemlighet som innehåller ett certifikat. Certifikatet är Base64-kodning av följande JSON-objekt (JavaScript Object Notation), som kodas i UTF-8: { "data": "<Base64-encoded-file>", "dataType": "<file-format>", "password": "<pfx-file-password>" } För närvarande accepterar dataType endast .pfx-filer.
| Type: | String |
| Position: | 3 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Autentiseringsuppgifterna, kontot, klientorganisationen och prenumerationen som används för kommunikation med Azure.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Anger resurs-ID för Key Vault som innehåller de certifikat som du kan lägga till på den virtuella datorn. Det här värdet fungerar också som nyckel för att lägga till flera certifikat. Det innebär att du kan använda samma värde för SourceVaultId när du lägger till flera certifikat från samma Key Vault.
| Type: | String |
| Aliases: | Id |
| Position: | 1 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Anger det virtuella datorobjekt som den här cmdleten ändrar. Om du vill hämta ett virtuellt datorobjekt använder du cmdleten Get-AzVM . Du kan använda cmdleten New-AzVMConfig för att skapa ett virtuellt datorobjekt.
| Type: | PSVirtualMachine |
| Aliases: | VMProfile |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |