Dela via


Set-AzureRmVMCustomScriptExtension

Lägger till ett anpassat skripttillägg till en virtuell dator.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

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

Cmdleten Set-AzureRmVMCustomScriptExtension lägger till ett anpassat tillägg för virtuella datorer till en virtuell dator. Med det här tillägget kan du köra egna skript på den virtuella datorn.

Exempel

Exempel 1: Lägg till ett anpassat skript

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"

Det här kommandot lägger till ett anpassat skript till den virtuella datorn med namnet VirtualMachine07. Skriptfilen är contososcript.exe.

Parametrar

-Argument

Anger argument som skripttillägget skickar till skriptet.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Aliases:cf
Position:Named
standardvärde:False
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-ContainerName

Anger namnet på Azure Storage-containern där den här cmdleten lagrar skriptet.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableAutoUpgradeMinorVersion

Typ:SwitchParameter
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-FileName

Anger namnet på skriptfilen. Om filen lagras i Azure Blob Storage är filnamnsvärdet skiftlägeskänsligt. Filnamn för filer som lagras i Azure File Storage är inte skiftlägeskänsliga.

Typ:String[]
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-FileUri

Anger URI:n för skriptfilen.

Typ:String[]
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-ForceRerun

Anger att denna cmdlet tvingar fram en omkörning av samma tilläggskonfiguration på den virtuella datorn utan att avinstallera och installera om tillägget. Värdet kan vara valfri sträng som skiljer sig från det aktuella värdet. Om forceUpdateTag inte ändras tillämpas uppdateringar av offentliga eller skyddade inställningar fortfarande av hanteraren.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

Anger platsen för den virtuella datorn.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Anger namnet på det anpassade skripttillägget.

Typ:String
Aliases:ExtensionName
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Anger namnet på resursgruppen för den virtuella datorn.

Typ:String
Position:0
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-Run

Anger det kommando som ska användas för att köra skriptet.

Typ:String
Aliases:RunFile, Command
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-SecureExecution

Anger att den här cmdleten ser till att värdet för körparametern inte loggas på servern eller returneras till användaren med hjälp av GET-tilläggs-API:et. Värdet för Kör kan innehålla hemligheter eller lösenord som ska skickas till skriptfilen på ett säkert sätt.

Typ:SwitchParameter
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountKey

Anger nyckeln för Azure Storage-containern.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountName

Anger namnet på det Azure Storage-konto där den här cmdleten lagrar skriptet.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageEndpointSuffix

Anger suffixet för lagringsslutpunkten.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-TypeHandlerVersion

Anger vilken version av tillägget som ska användas för den här virtuella datorn. Hämta versionen genom att köra cmdleten Get-AzureRmVMExtensionImage med värdet Microsoft.Compute för parametern PublisherName och VMAccessAgent för parametern Type .

Typ:String
Aliases:HandlerVersion, Version
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-VMName

Anger namnet på en virtuell dator. Den här cmdleten lägger till det anpassade skripttillägget för den virtuella datorn som den här parametern anger.

Typ:String
Aliases:ResourceName
Position:1
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Aliases:wi
Position:Named
standardvärde:False
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

Indata

String

String[]

SwitchParameter

Utdata

PSAzureOperationResponse