フィードバック

Add-AzVmssSecret

  • リファレンス
モジュール:
Az.Compute

VMSS にシークレットを追加します。

構文

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

説明

Add-AzVmssSecret コマンドレットは、仮想マシン スケール セット (VMSS) にシークレットを追加します。 シークレットは、Azure Key Vaultに格納する必要があります。 Key Vaultに関する詳細については、「Azure Key Vaultとは()https://docs.microsoft.com/azure/key-vault/general/basic-concepts」を参照してください。 コマンドレットの詳細については、「Azure Key Vault コマンドレット」または Set-AzKeyVaultSecret コマンドレットを参照してください。

例

例 1: Azure Key Vault 仮想マシン拡張機能を使用して VMSS にシークレットを追加する

# 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

仮想マシンに証明書をインストールするには、Linux 用の Azure Key Vault仮想マシン拡張機能または Windows 用 Azure Key Vault仮想マシン拡張機能を使用することをお勧めします。

例 2: Add-AzVmssSecretを使用して VMSS にシークレットを追加する

$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

この例では、VMSS にシークレットを追加します。 最初のコマンドでは、Get-AzKeyVault コマンドレットを使用して ContosoVault という名前のコンテナーからコンテナー シークレットを取得し、結果を $Vault という名前の変数に格納します。 2 番目のコマンドでは、New-AzVmssVaultCertificateConfig コマンドレットを使用して、証明書という名前の証明書ストアから指定した証明書 URL を使用してKey Vault証明書構成を作成し、結果を $CertConfig という名前の変数に格納します。 3 番目のコマンドでは、 New-AzVmssConfig コマンドレットを使用して VMSS 構成オブジェクトを作成し、結果を $VMSS という名前の変数に格納します。 4 番目のコマンドでは、キー リソース ID と、$Vault変数と$CertConfig変数に格納されているコンテナー証明書を使用して、コンテナー シークレットを使用して VMSS にシークレットを追加します。

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SourceVaultId

仮想マシンに追加できる証明書を含むKey Vaultのリソース ID を指定します。 この値は、複数の証明書を追加するためのキーとしても機能します。 つまり、同じKey Vaultから複数の証明書を追加するときに、SourceVaultId パラメーターに同じ値を使用できます。

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

証明書の URL と 証明書 名を含むコンテナー証明書オブジェクトを指定します。 New-AzVmssVaultCertificateConfig コマンドレットを使用して、このオブジェクトを作成できます。

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

VMSS オブジェクトを指定します。 New-AzVmssConfig コマンドレットを使用して、このオブジェクトを作成できます。

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

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

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

入力

PSVirtualMachineScaleSet

String

VaultCertificate[]

出力

PSVirtualMachineScaleSet