Share via

Set-AzureRmVMCustomScriptExtension

  • Referencia
Modul:
AzureRM.Compute

Egyéni szkriptbővítményt ad hozzá egy virtuális géphez.

Figyelmeztetés

Az AzureRM PowerShell-modul 2024. február 29-én hivatalosan elavult. Javasoljuk a felhasználóknak, hogy migráljanak az AzureRM-ből az Az PowerShell-modulba a folyamatos támogatás és frissítések biztosítása érdekében.

Bár az AzureRM-modul továbbra is működik, a továbbiakban nem tart fenn vagy nem támogatott, így a folyamatos használatot a felhasználó saját belátása szerint és kockázatára teheti. Az Az modulra való áttéréshez tekintse meg a migrálási erőforrásainkat.

Syntax

Set-AzureRmVMCustomScriptExtension
   -ContainerName <String>
   -FileName <String[]>
   [-StorageAccountName <String>]
   [-StorageEndpointSuffix <String>]
   [-StorageAccountKey <String>]
   [-Run <String>]
   [-Argument <String>]
   [-SecureExecution]
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [-Name <String>]
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureRmVMCustomScriptExtension
   [-FileUri <String[]>]
   [-Run <String>]
   [-Argument <String>]
   [-SecureExecution]
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [-Name <String>]
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

A Set-AzureRmVMCustomScriptExtension parancsmag egy egyéni szkript virtuálisgép-bővítményt ad hozzá egy virtuális géphez. Ezzel a bővítménysel saját szkripteket futtathat a virtuális gépen.

Példák

1. példa: Egyéni szkript hozzáadása

PS C:\> Set-AzureRmVMCustomScriptExtension -ResourceGroupName "ResourceGroup11" -Location "Central US" -VMName "VirtualMachine07" -Name "ContosoTest" -TypeHandlerVersion "1.1" -StorageAccountName "Contoso" -StorageAccountKey <StorageKey> -FileName "ContosoScript.exe" -ContainerName "Scripts"

Ez a parancs hozzáad egy egyéni szkriptet a VirtualMachine07 nevű virtuális géphez. A szkriptfájl contososcript.exe.

Paraméterek

-Argument

Megadja azokat az argumentumokat, amelyeket a szkriptbővítmény átad a szkriptnek.

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

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

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

-ContainerName

Megadja annak az Azure Storage-tárolónak a nevét, amelyben ez a parancsmag tárolja a szkriptet.

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

-DefaultProfile

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

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

-DisableAutoUpgradeMinorVersion

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

-FileName

Megadja a szkriptfájl nevét. Ha a fájl az Azure Blob Storage-ban van tárolva, a fájlnév értéke kis- és nagybetűkre érzékeny. Az Azure File Storage-ban tárolt fájlok fájlnevei nem kis- és nagybetűk.

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

-FileUri

A szkriptfájl URI-ját adja meg.

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

-ForceRerun

Azt jelzi, hogy ez a parancsmag ugyanazon bővítménykonfiguráció újrafuttatását kényszeríti a virtuális gépen a bővítmény eltávolítása és újratelepítése nélkül. Az érték bármilyen sztring lehet, amely eltér az aktuális értéktől. Ha a forceUpdateTag nem módosul, a kezelő továbbra is alkalmazza a nyilvános vagy védett beállítások frissítéseit.

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

-Location

Megadja a virtuális gép helyét.

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

-Name

Megadja az egyéni szkriptbővítmény nevét.

Type:String
Aliases:ExtensionName
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Megadja a virtuális gép erőforráscsoportjának nevét.

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

-Run

Megadja a szkriptet futtató parancsot.

Type:String
Aliases:RunFile, Command
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SecureExecution

Azt jelzi, hogy ez a parancsmag gondoskodik arról, hogy a Futtatás paraméter értéke ne legyen naplózva a kiszolgálón, vagy a GET bővítmény API használatával adja vissza a felhasználónak. A Futtatás érték tartalmazhat titkos kulcsokat vagy jelszavakat, amelyek biztonságosan továbbíthatók a szkriptfájlnak.

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

-StorageAccountKey

Megadja az Azure Storage-tároló kulcsát.

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

-StorageAccountName

Megadja annak az Azure Storage-fióknak a nevét, ahol ez a parancsmag tárolja a szkriptet.

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

-StorageEndpointSuffix

Megadja a tárolási végpont utótagját.

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

-TypeHandlerVersion

A virtuális géphez használandó bővítmény verzióját adja meg. A verzió beszerzéséhez futtassa a Get-AzureRmVMExtensionImage parancsmagot a PublisherName paraméterHez tartozó Microsoft.Compute és a Típus paraméter VMAccessAgent értékével.

Type:String
Aliases:HandlerVersion, Version
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VMName

A virtuális gép nevét adja meg. Ez a parancsmag hozzáadja a paraméter által megadott virtuális gép egyéni szkriptbővítményét.

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

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

Bevitelek

String

String[]

SwitchParameter

Kimenetek

PSAzureOperationResponse