Compartir a través de

Add-AzureRmVMSecret

  • Referencia
Módulo:
AzureRM.Compute

Agrega un secreto a una máquina virtual.

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Syntax

Add-AzureRmVMSecret
   [-VM] <PSVirtualMachine>
   [[-SourceVaultId] <String>]
   [[-CertificateStore] <String>]
   [[-CertificateUrl] <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

El cmdlet Add-AzureRmVMSecret agrega un secreto a una máquina virtual. Este valor le permite agregar un certificado a la máquina virtual. El secreto debe almacenarse en un almacén de claves. Para más información sobre Key Vault, consulte ¿Qué es Azure Key Vault? Para más información sobre los cmdlets, consulte Cmdlets de Azure Key Vault en la biblioteca microsoft Developer Network o el cmdlet Set-AzureKeyVaultSecret .

Ejemplos

Ejemplo 1: Agregar un secreto a una máquina virtual

PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
PS C:\> $Credential = Get-Credential
PS C:\> $VirtualMachine = Set-AzureRmVMOperatingSystem -VM $VirtualMachine  -Windows -ComputerName "Contoso26" -Credential $Credential
PS C:\> $SourceVaultId = "/subscriptions/46f8cea4-2de6-4179-8ab1-365da4211af4/resourceGroups/vault/providers/Microsoft.KeyVault/vaults/keyvault"
PS C:\> $CertificateStore01 = "My"
PS C:\> $CertificateUrl01 = "https://contosovault.vault.azure.net/secrets/514ceb769c984379a7e0230bdd703272"
PS C:\> $VirtualMachine = Add-AzureRmVMSecret -VM $VirtualMachine -SourceVaultId $SourceVaultId -CertificateStore $CertificateStore01 -CertificateUrl $CertificateUrl01

El primer comando crea un objeto de máquina virtual y, a continuación, lo almacena en la variable $VirtualMachine. El comando asigna un nombre y un tamaño a la máquina virtual. El segundo comando crea un objeto de credencial mediante el cmdlet Get-Credential y, a continuación, almacena el resultado en la variable $Credential. El comando le pide un nombre de usuario y una contraseña. Para obtener más información, escriba Get-Help Get-Credential. El tercer comando usa el cmdlet Set-AzureRmVMOperatingSystem para configurar la máquina virtual almacenada en $VirtualMachine. El cuarto comando asigna un identificador del almacén de origen a la variable $SourceVaultId para su uso posterior. El comando supone que la variable $SubscriptionId tiene un valor adecuado. El quinto comando asigna un valor a la variable $CertificateStore 01 para su uso posterior. El sexto comando asigna una dirección URL para un almacén de certificados. El séptimo comando agrega un secreto a la máquina virtual almacenada en $VirtualMachine. El parámetro SourceVaultId especifica key Vault. El comando especifica el nombre del almacén de certificados y la dirección URL del certificado. Puede ejecutar Add-AzureRmVMSecret repetidamente para agregar secretos para otros certificados.

Parámetros

-CertificateStore

Especifica el nombre de un almacén de certificados en la máquina virtual que ejecuta el sistema operativo Windows. Este cmdlet agrega el certificado al almacén que especifica este parámetro. Solo puede especificar este parámetro para las máquinas virtuales que ejecutan el sistema operativo Windows.

Tipo:String
Position:2
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-CertificateUrl

Especifica la dirección URL que apunta a un secreto de Key Vault que contiene un certificado. El certificado es la codificación Base64 del siguiente objeto notación de objetos JavaScript (JSON), que se codifica en UTF-8: { "data": "<Base64-encoded-file>", "dataType": "<file-format>", "password": "<pfx-file-password>" } Actualmente, dataType acepta solo archivos .pfx.

Tipo:String
Position:3
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceVaultId

Especifica el identificador de recurso del almacén de claves que contiene los certificados que puede agregar a la máquina virtual. Este valor también actúa como clave para agregar varios certificados. Esto significa que puede usar el mismo valor para SourceVaultId al agregar varios certificados desde el mismo almacén de claves.

Tipo:String
Aliases:Id
Position:1
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-VM

Especifica el objeto de máquina virtual que modifica este cmdlet. Para obtener un objeto de máquina virtual, use el cmdlet Get-AzureRmVM . Puede usar el cmdlet New-AzureRmVMConfig para crear un objeto de máquina virtual.

Tipo:PSVirtualMachine
Aliases:VMProfile
Position:0
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

Entradas

PSVirtualMachine

String

Salidas

PSVirtualMachine