Sdílet prostřednictvím

Add-AzVmssExtension

  • Reference
Modul:
Az.Compute

Přidá do VMSS rozšíření.

Syntaxe

Add-AzVmssExtension
   [-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>
   [[-Name] <String>]
   [[-Publisher] <String>]
   [[-Type] <String>]
   [[-TypeHandlerVersion] <String>]
   [[-AutoUpgradeMinorVersion] <Boolean>]
   [[-Setting] <Object>]
   [[-ProtectedSetting] <Object>]
   [-EnableAutomaticUpgrade <Boolean>]
   [-ForceUpdateTag <String>]
   [-ProvisionAfterExtension <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Rutina Add-AzVmssExtension přidá rozšíření do škálovací sady virtuálních počítačů (VMSS).

Příklady

Příklad 1: Přidání rozšíření do VMSS

Add-AzVmssExtension -VirtualMachineScaleSet $VMSS -Name $ExtName -Publisher $Publisher -Type $ExtType -TypeHandlerVersion $ExtVer -AutoUpgradeMinorVersion $True

Tento příkaz přidá do VMSS rozšíření.

Příklad 2: Přidání rozšíření do VMSS s nastavením a chráněnými nastaveními

$Settings = @{"fileUris" = "[]"; "commandToExecute" = ""};
$ProtectedSettings = @{"storageAccountName" = $stoname; "storageAccountKey" = $stokey};

Add-AzVmssExtension -VirtualMachineScaleSet $vmss -Name $vmssExtensionName -Publisher $vmssPublisher  `
  -Type $vmssExtensionType -TypeHandlerVersion $ExtVer -AutoUpgradeMinorVersion $True  `
  -Setting $Settings -ProtectedSetting $ProtectedSettings

Příklad 3: Přidání rozšíření do VMSS s nastavením a chráněným nastavením

$BatchFile = "runbook.sh"
$ResourceGroupName = "HelloRG"
$VMScaleSetName = "HelloVmSS"
$TypeHandlerVersion = 2.1

#Best Practice for securd paramaters.
$protectedSettings = @{
"managedIdentity" = @{ "clientId" = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"};
}

$publicSettings = @{ 
"fileUris"= (,"https://storage.blob.core.windows.net/itfiles/$($BatchFile)");
"commandToExecute"= "sh $($BatchFile)"
}

# Get information about the scale set
$vmss = Get-AzVmss `
            -ResourceGroupName $ResourceGroupName `
            -VMScaleSetName $VMScaleSetName

Add-AzVmssExtension -VirtualMachineScaleSet $vmss `
    -Name "CustomScript" `
    -Publisher "Microsoft.Azure.Extensions" `
    -Type "CustomScript" `
    -TypeHandlerVersion $TypeHandlerVersion `
    -AutoUpgradeMinorVersion $true `
    -Setting $publicSettings `
    -ProtectedSetting $protectedSettings

Update-AzVmss `
    -ResourceGroupName $ResourceGroupName `
    -Name $VMScaleSetName `
    -VirtualMachineScaleSet $vmss

Tento příkaz přidá do služby VMSS rozšíření s ukázkovým skriptem Bash v úložišti objektů blob, v nastavení a přístupu k zabezpečení v chráněných nastaveních zadejte adresu URL úložiště objektů blob a spustitelného příkazu.

Parametry

-AutoUpgradeMinorVersion

Určuje, jestli se má verze rozšíření automaticky aktualizovat na novější podverzi.

Typ:Nullable<T>[Boolean]
Position:5
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-EnableAutomaticUpgrade

Určuje, jestli má být rozšíření automaticky upgradováno platformou, pokud je k dispozici novější verze rozšíření.

Typ:Nullable<T>[Boolean]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ForceUpdateTag

Pokud je zadána hodnota a liší se od předchozí hodnoty, bude obslužná rutina rozšíření nucena aktualizovat i v případě, že konfigurace rozšíření nebyla změněna.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Určuje název rozšíření, které tato rutina přidá.

Typ:String
Position:1
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ProtectedSetting

Určuje privátní konfiguraci rozšíření jako řetězec. Tato rutina šifruje privátní konfiguraci.

Typ:Object
Position:7
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ProvisionAfterExtension

Kolekce názvů rozšíření, po kterých je potřeba toto rozšíření zřídit.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Publisher

Určuje název vydavatele rozšíření. Vydavatel zadá název, když vydavatel zaregistruje rozšíření. K získání vydavatele můžete použít rutinu Get-AzVMImagePublisher .

Typ:String
Position:2
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Setting

Určuje veřejnou konfiguraci rozšíření jako řetězec. Tato rutina nešifruje veřejnou konfiguraci.

Typ:Object
Position:6
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Type

Určuje typ rozšíření. K získání typu rozšíření můžete použít rutinu Get-AzVMExtensionImageType .

Typ:String
Position:3
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-TypeHandlerVersion

Určuje verzi rozšíření, která se má použít pro tento virtuální počítač. K získání verze rozšíření můžete použít rutinu Get-AzVMExtensionImage .

Typ:String
Position:4
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-VirtualMachineScaleSet

Zadejte objekt VMSS. K vytvoření objektu můžete použít New-AzVmssConfig .

Typ:PSVirtualMachineScaleSet
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

PSVirtualMachineScaleSet

String

Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Object

Výstupy

PSVirtualMachineScaleSet