Add-AzVmssExtension
Bővítményt ad hozzá a VMSS-hez.
Syntax
Default (Alapértelmezett)
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
Az Add-AzVmssExtension parancsmag bővítményt ad hozzá a virtuálisgép-méretezési csoporthoz (VMSS).
Példák
1. példa: Bővítmény hozzáadása a VMSS-hez
Add-AzVmssExtension -VirtualMachineScaleSet $VMSS -Name $ExtName -Publisher $Publisher -Type $ExtType -TypeHandlerVersion $ExtVer -AutoUpgradeMinorVersion $True
Ez a parancs hozzáad egy bővítményt a VMSS-hez.
2. példa: Bővítmény hozzáadása a VMSS-hez beállításokkal és védett beállításokkal
$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
3. példa: Bővítmény hozzáadása a VMSS-hez beállításokkal és védett beállításokkal
$BatchFile = "runbook.sh"
$ResourceGroupName = "HelloRG"
$VMScaleSetName = "HelloVmSS"
$TypeHandlerVersion = 2.1
#Best Practice for secured parameters.
$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
Ez a parancs hozzáad egy bővítményt a VMSS-hez egy blobtárolón lévő bash-mintaszkripttel, megadja a Blob Storage URL-címét és a végrehajtható parancsot a beállításokban, a biztonsági hozzáférést pedig a védett beállításokban.
Paraméterek
-AutoUpgradeMinorVersion
Azt jelzi, hogy a bővítményverziót automatikusan frissíteni kell-e egy újabb alverzióra.
Paramétertulajdonságok
Típus: Nullable<T> [ Boolean ]
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: 5 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
-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
-EnableAutomaticUpgrade
Azt jelzi, hogy a bővítményt automatikusan frissítenie kell-e a platformnak, ha a bővítmény újabb verziója érhető el.
Paramétertulajdonságok
Típus: Nullable<T> [ Boolean ]
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
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
-ForceUpdateTag
Ha egy érték meg van adva, és eltér az előző értéktől, a bővítménykezelőt akkor is frissítenie kell, ha a bővítménykonfiguráció nem változott.
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: Named 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
-Name
Megadja a parancsmag által hozzáadott bővítmény nevét.
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
-ProtectedSetting
Sztringként adja meg a bővítmény privát konfigurációját.
Ez a parancsmag titkosítja a privát konfigurációt.
Paramétertulajdonságok
Típus: Object
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: 7 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
-ProvisionAfterExtension
Olyan bővítménynevek gyűjteménye, amelyek után ezt a bővítményt ki kell építeni.
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: Named 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
-Publisher
Megadja a bővítmény közzétevőjének nevét.
A közzétevő akkor ad nevet, ha a közzétevő regisztrál egy bővítményt.
Ez a Get-AzVMImagePublisher parancsmaggal szerezheti be a közzétevőt.
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: 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
-Setting
A bővítmény nyilvános konfigurációját adja meg sztringként.
Ez a parancsmag nem titkosítja a nyilvános konfigurációt.
Paramétertulajdonságok
Típus: Object
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: 6 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
-Type
Megadja a bővítmény típusát.
A Get-AzVMExtensionImageType parancsmaggal lekérheti a bővítmény típusát.
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: 3 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
-TypeHandlerVersion
A virtuális géphez használandó bővítmény verzióját adja meg.
A Get-AzVMExtensionImage parancsmaggal lekérheti a bővítmény verzióját.
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: 4 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
Adja meg a VMSS-objektumot.
Az objektum létrehozásához használhatja a New-AzVmssConfigot .
Paramétertulajdonságok
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 .
Kimenetek
