Add-AzVmssSecret

  • Referencia
Módulo:
Az.Compute

Agrega un secreto a un VMSS.

Syntax

Add-AzVmssSecret
   [-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>
   [[-SourceVaultId] <String>]
   [[-VaultCertificate] <VaultCertificate[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Add-AzVmssSecret agrega un secreto al conjunto de escalado de máquinas virtuales (VMSS). El secreto debe almacenarse en una instancia de Azure Key Vault. Para más información sobre Key Vault, consulte ¿Qué es Azure Key Vault? (https://learn.microsoft.com/azure/key-vault/general/basic-concepts). Para más información sobre los cmdlets, consulte Cmdlets de Azure Key Vault o el cmdlet Set-AzKeyVaultSecret .

Ejemplos

Ejemplo 1: Adición de un secreto a VMSS mediante la extensión de máquina virtual de Azure Key Vault

# Build settings
$settings = @{
    secretsManagementSettings = @{
        pollingIntervalInS       = "<pollingInterval>"
        certificateStoreName     = "<certStoreName>"
        certificateStoreLocation = "<certStoreLoc>"
        observedCertificates     = @("<observedCert1>", "<observedCert2>")
    } 
} | ConvertTo-Json
$extName = "KeyVaultForLinux"
$extPublisher = "Microsoft.Azure.KeyVault"
$extType = "KeyVaultForLinux"
# Add Extension to VMSS
$vmss = Get-AzVmss -ResourceGroupName <ResourceGroupName> -VMScaleSetName <VmssName>
Add-AzVmssExtension -VirtualMachineScaleSet $vmss  -Name $extName -Publisher $extPublisher -Type $extType -TypeHandlerVersion "2.0" -Setting $settings
# Start the deployment
Update-AzVmss -ResourceGroupName <ResourceGroupName> -VMScaleSetName <VmssName> -VirtualMachineScaleSet $vmss

Para instalar certificados en una máquina virtual, se recomienda usar la extensión de máquina virtual de Azure Key Vault para Linux o la extensión de máquina virtual de Azure Key Vault para Windows.

Ejemplo 2: Adición de un secreto a VMSS mediante Add-AzVmssSecret

$Vault = Get-AzKeyVault -VaultName "ContosoVault"
$CertConfig = New-AzVmssVaultCertificateConfig -CertificateUrl "http://keyVaultName.vault.contoso.net/secrets/secretName/secretVersion" -CertificateStore "Certificates"
$VMSS = New-AzVmssConfig
Add-AzVmssSecret -VirtualMachineScaleSet $VMSS -SourceVaultId $Vault.ResourceId -VaultCertificate $CertConfig

En este ejemplo se agrega un secreto a VMSS. El primer comando usa el cmdlet Get-AzKeyVault para obtener un secreto de almacén del almacén denominado ContosoVault y almacena el resultado en la variable denominada $Vault. El segundo comando usa el cmdlet New-AzVmssVaultCertificateConfig para crear una configuración de certificado de Key Vault mediante la dirección URL de certificado especificada del almacén de certificados denominado Certificates y almacena los resultados en la variable denominada $CertConfig. El tercer comando usa el cmdlet New-AzVmssConfig para crear un objeto de configuración de VMSS y almacena el resultado en la variable denominada $VMSS. El cuarto comando agrega un secreto a VMSS mediante el secreto del almacén mediante el identificador de recurso de clave y el certificado del almacén almacenados en las variables de $Vault y $CertConfig.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required: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 el parámetro SourceVaultId al agregar varios certificados desde el mismo almacén de claves.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VaultCertificate

Especifica el objeto Vault Certificate que contiene la dirección URL del certificado y el nombre del certificado. Puede usar el cmdlet New-AzVmssVaultCertificateConfig para crear este objeto.

Type:VaultCertificate[]
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VirtualMachineScaleSet

Especifica el objeto VMSS. Puede usar el cmdlet New-AzVmssConfig para crear este objeto.

Type:PSVirtualMachineScaleSet
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

PSVirtualMachineScaleSet

String

VaultCertificate[]

Salidas

PSVirtualMachineScaleSet