Set-AzVMCustomScriptExtension
Egyéni szkriptbővítményt ad hozzá egy virtuális géphez.
Syntax
ByNameWithContainerAndFileNamesParameterSet (Alapértelmezett)
Set-AzVMCustomScriptExtension
[-ResourceGroupName] <String>
[-VMName] <String>
-ContainerName <String>
-FileName <String[]>
[-Name <String>]
[-StorageAccountName <String>]
[-StorageEndpointSuffix <String>]
[-StorageAccountKey <String>]
[-Run <String>]
[-Argument <String>]
[-SecureExecution]
[-TypeHandlerVersion <String>]
[-Location <String>]
[-DisableAutoUpgradeMinorVersion]
[-ForceRerun <String>]
[-NoWait]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByNameWithFileUriParameterSet
Set-AzVMCustomScriptExtension
[-ResourceGroupName] <String>
[-VMName] <String>
[-Name <String>]
[-FileUri <String[]>]
[-Run <String>]
[-Argument <String>]
[-SecureExecution]
[-TypeHandlerVersion <String>]
[-Location <String>]
[-DisableAutoUpgradeMinorVersion]
[-ForceRerun <String>]
[-NoWait]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByParentObjectWithContainerAndFileNamesParameterSet
Set-AzVMCustomScriptExtension
-Name <String>
-VMObject <PSVirtualMachine>
-ContainerName <String>
-FileName <String[]>
[-StorageAccountName <String>]
[-StorageEndpointSuffix <String>]
[-StorageAccountKey <String>]
[-Run <String>]
[-Argument <String>]
[-SecureExecution]
[-TypeHandlerVersion <String>]
[-Location <String>]
[-DisableAutoUpgradeMinorVersion]
[-ForceRerun <String>]
[-NoWait]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByParentObjectWithFileUriParameterSet
Set-AzVMCustomScriptExtension
-Name <String>
-VMObject <PSVirtualMachine>
[-FileUri <String[]>]
[-Run <String>]
[-Argument <String>]
[-SecureExecution]
[-TypeHandlerVersion <String>]
[-Location <String>]
[-DisableAutoUpgradeMinorVersion]
[-ForceRerun <String>]
[-NoWait]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByResourceIdWithContainerAndFileNamesParameterSet
Set-AzVMCustomScriptExtension
-ResourceId <String>
-ContainerName <String>
-FileName <String[]>
[-StorageAccountName <String>]
[-StorageEndpointSuffix <String>]
[-StorageAccountKey <String>]
[-Run <String>]
[-Argument <String>]
[-SecureExecution]
[-TypeHandlerVersion <String>]
[-Location <String>]
[-DisableAutoUpgradeMinorVersion]
[-ForceRerun <String>]
[-NoWait]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByResourceIdWithFileUriParameterSet
Set-AzVMCustomScriptExtension
-ResourceId <String>
[-FileUri <String[]>]
[-Run <String>]
[-Argument <String>]
[-SecureExecution]
[-TypeHandlerVersion <String>]
[-Location <String>]
[-DisableAutoUpgradeMinorVersion]
[-ForceRerun <String>]
[-NoWait]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzVMCustomScriptExtension
-InputObject <VirtualMachineCustomScriptExtensionContext>
-ContainerName <String>
-FileName <String[]>
[-StorageAccountName <String>]
[-StorageEndpointSuffix <String>]
[-StorageAccountKey <String>]
[-Run <String>]
[-Argument <String>]
[-SecureExecution]
[-TypeHandlerVersion <String>]
[-Location <String>]
[-DisableAutoUpgradeMinorVersion]
[-ForceRerun <String>]
[-NoWait]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzVMCustomScriptExtension
-InputObject <VirtualMachineCustomScriptExtensionContext>
[-FileUri <String[]>]
[-Run <String>]
[-Argument <String>]
[-SecureExecution]
[-TypeHandlerVersion <String>]
[-Location <String>]
[-DisableAutoUpgradeMinorVersion]
[-ForceRerun <String>]
[-NoWait]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
A Set-AzVMCustomScriptExtension 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
Set-AzVMCustomScriptExtension -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.
2. példa
Egyéni szkriptbővítményt ad hozzá egy virtuális géphez. (autogenerated)
Set-AzVMCustomScriptExtension -Argument <String> -ContainerName 'Scripts' -DefaultProfile <IAzureContextContainer> -FileName 'ContosoScript.exe' -Location 'Central US' -Name 'ContosoTest' -ResourceGroupName 'ResourceGroup11' -Run 'myScript.ps1' -SecureExecution -StorageAccountKey <String> -StorageAccountName 'Contoso' -TypeHandlerVersion '1.1' -VMName 'VirtualMachine07'
Paraméterek
-Argument
Megadja azokat az argumentumokat, amelyeket a szkriptbővítmény átad a szkriptnek.
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
-Confirm
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
Típus: SwitchParameter
Alapértelmezett érték: False
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
-ContainerName
Annak a Azure tárolónak a nevét adja meg, amelyben ez a parancsmag tárolja a szkriptet.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
ByNameWithContainerAndFileNamesParameterSet
Position: Named
Kötelező: True
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
-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
-DisableAutoUpgradeMinorVersion
A Set-AzVMCustomScriptExtension 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.
Paramétertulajdonságok
Típus: SwitchParameter
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
-FileName
Megadja a szkriptfájl nevét. Ha a fájl Azure Blob Storage-ban van tárolva, a fájlnév értéke megkülönbözteti a kis- és nagybetűk értékét. A Azure Fájltárolóban tárolt fájlok fájlneve nem megkülönbözteti a kis- és nagybetűket.
Paramétertulajdonságok
Típus: String [ ]
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
ByNameWithContainerAndFileNamesParameterSet
Position: Named
Kötelező: True
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
-FileUri
A szkriptfájl URI-ját adja meg.
Paramétertulajdonságok
Típus: String [ ]
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
ByNameWithFileUriParameterSet
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
-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.
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
Virtuálisgép-bővítményobjektum.
ByInputObjectWithContainerAndFileNamesParameterSet
Position: Named
Kötelező: True
Folyamatból származó érték: True
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
ByInputObjectWithFileUriParameterSet
Position: Named
Kötelező: True
Folyamatból származó érték: True
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-Location
Megadja a virtuális gép helyé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: 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 az egyéni szkriptbő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
Aliasok: ExtensionName
Paraméterkészletek
ByNameWithContainerAndFileNamesParameterSet
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
ByNameWithFileUriParameterSet
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
-NoWait
Elindítja a műveletet, és azonnal visszatér, mielőtt a művelet befejeződik. Annak megállapításához, hogy a művelet sikeresen befejeződött-e, használjon más mechanizmust.
Paramétertulajdonságok
Típus: SwitchParameter
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
-ResourceGroupName
Megadja a virtuális gép erőforráscsoportjának 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
ByNameWithContainerAndFileNamesParameterSet
Position: 0
Kötelező: True
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
ByNameWithFileUriParameterSet
Position: 0
Kötelező: True
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
-ResourceId
A ResourceID virtuálisgép-bővítmény.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
ByResourceIdWithContainerAndFileNamesParameterSet
Position: Named
Kötelező: True
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
ByResourceIdWithFileUriParameterSet
Position: Named
Kötelező: True
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
-Run
Megadja a szkriptet futtató parancsot.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Aliasok: RunFile, Command
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
-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.
Paramétertulajdonságok
Típus: SwitchParameter
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
-StorageAccountKey
Megadja a Azure tároló kulcsát.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
ByNameWithContainerAndFileNamesParameterSet
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
-StorageAccountName
Megadja annak a Azure tárfióknak a nevét, ahol ez a parancsmag tárolja a szkriptet.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
ByNameWithContainerAndFileNamesParameterSet
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
-StorageEndpointSuffix
Megadja a tárolási végpont utótagját.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
ByNameWithContainerAndFileNamesParameterSet
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
-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-AzVMExtensionImage parancsmagot Microsoft értékkel. Számítás a PublisherName paraméterhez és a CustomScriptExtension paraméterhez a Type paraméterhez.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Aliasok: HandlerVersion, Változat
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
-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.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Aliasok: ResourceName
Paraméterkészletek
ByNameWithContainerAndFileNamesParameterSet
Position: 1
Kötelező: True
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
ByNameWithFileUriParameterSet
Position: 1
Kötelező: True
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
-VMObject
Virtuálisgép-objektum.
Paramétertulajdonságok
Típus: PSVirtualMachine
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
ByParentObjectWithContainerAndFileNamesParameterSet
Position: Named
Kötelező: True
Folyamatból származó érték: True
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
ByParentObjectWithFileUriParameterSet
Position: Named
Kötelező: True
Folyamatból származó érték: True
Folyamatból származó érték tulajdonságnév alapján: False
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: False
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