Add-AzVmssSecret

Titkos kulcsot ad hozzá egy VMSS-hez.

Syntax

Default (Alapértelmezett)

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

Description

Az Add-AzVmssSecret parancsmag titkos kulcsot ad hozzá a virtuálisgép-méretezési csoporthoz (VMSS). A titkos kulcsot egy Azure Key Vault kell tárolni. A Key Vault kapcsolatos további információkért lásd: Mi Azure Key Vault? (https://learn.microsoft.com/azure/key-vault/general/basic-concepts). A parancsmagokkal kapcsolatos további információkért lásd: Azure Key Vault parancsmagok vagy a Set-AzKeyVaultSecret parancsmag.

Példák

1. példa: Titkos kód hozzáadása a VMSS-hez a Azure Key Vault virtuálisgép-bővítmény használatával

# 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

A tanúsítványok virtuális gépekre való telepítéséhez ajánlott a Azure Key Vault virtuálisgép-bővítmény használata Linux vagy a Windows Azure Key Vault virtuálisgép-bővítménye.

2. példa: Titkos kód hozzáadása a VMSS-hez 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

Ez a példa egy titkos kulcsot ad hozzá a VMSS-hez. Az első parancs a Get-AzKeyVault parancsmagot használja a ContosoVault nevű tároló titkos kulcsának lekéréséhez, és az eredményt a $Vault nevű változóban tárolja. A második parancs a New-AzVmssVaultCertificateConfig parancsmaggal hoz létre egy Key Vault tanúsítványkonfigurációt a Tanúsítványok nevű tanúsítványtároló megadott TANÚSÍTVÁNY URL-címével, és az eredményeket a $CertConfig nevű változóban tárolja. A harmadik parancs a New-AzVmssConfig parancsmaggal hoz létre egy VMSS konfigurációs objektumot, és az eredményt a $VMSS nevű változóban tárolja. A negyedik parancs egy titkos kulcsot ad hozzá a VMSS-hez a kulcserőforrás-azonosító, valamint a $Vault és $CertConfig változókban tárolt tárolótanúsítvány használatával.

Paraméterek

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Cf

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

Paramétertulajdonságok

Típus:IAzureContextContainer
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:AzContext, AzureRmContext, AzureCredential

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-SourceVaultId

Megadja a virtuális géphez hozzáadható tanúsítványokat tartalmazó Key Vault erőforrás-azonosítóját. Ez az érték több tanúsítvány hozzáadásának kulcsa is. Ez azt jelenti, hogy ugyanazt az értéket használhatja a SourceVaultId paraméterhez, ha ugyanazon Key Vault több tanúsítványt is hozzáad.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:1
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-VaultCertificate

Megadja a tanúsítvány URL-címét és a tanúsítvány nevét tartalmazó tárolótanúsítvány-objektumot . Az objektum létrehozásához használhatja a New-AzVmssVaultCertificateConfig parancsmagot.

Paramétertulajdonságok

Típus:

VaultCertificate[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:2
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-VirtualMachineScaleSet

Megadja a VMSS-objektumot. Az objektum létrehozásához használhatja a New-AzVmssConfig parancsmagot.

Paramétertulajdonságok

Típus:PSVirtualMachineScaleSet
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:0
Kötelező:True
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Wi

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

PSVirtualMachineScaleSet

String

VaultCertificate

Kimenetek

PSVirtualMachineScaleSet