Sdílet prostřednictvím

Set-AzureVMCustomScriptExtension

  • Reference
Modul:
Azure

Nastaví informace pro rozšíření vlastních skriptů virtuálního počítače Azure.

Poznámka:

Rutiny, na které odkazuje tato dokumentace, slouží ke správě starších prostředků Azure, které používají rozhraní API Azure Service Manageru (ASM). Tento starší modul PowerShellu se nedoporučuje při vytváření nových prostředků, protože ASM je naplánované pro vyřazení z provozu. Další informace najdete v části Vyřazení Azure Service Manageru.

Modul Az PowerShell je doporučený modul PowerShellu pro správu prostředků Azure Resource Manageru (ARM) pomocí PowerShellu.

Syntaxe

Set-AzureVMCustomScriptExtension
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   [-ContainerName] <String>
   [-FileName] <String[]>
   [[-StorageAccountName] <String>]
   [[-StorageEndpointSuffix] <String>]
   [[-StorageAccountKey] <String>]
   [[-Run] <String>]
   [[-Argument] <String>]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureVMCustomScriptExtension
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   [-Disable]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureVMCustomScriptExtension
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   [-Uninstall]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureVMCustomScriptExtension
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   [[-FileUri] <String[]>]
   [-Run] <String>
   [[-Argument] <String>]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

Rutina Set-AzureVMCustomScriptExtension nastavuje informace pro rozšíření vlastních skriptů virtuálního počítače Azure.

Příklady

Příklad 1: Nastavení informací pro rozšíření vlastních skriptů virtuálního počítače

PS C:\> $VM = Set-AzureVMCustomScriptExtension -VM $VM -ContainerName "Container01" -FileName "script1.ps1","script2.ps1" -Run "script1.ps1" -Argument "arg1 arg2";
PS C:\> New-AzureVM -Location "West US" -ServiceName $SVC -VM $VM;

Tento příkaz nastaví informace o rozšíření vlastních skriptů virtuálního počítače.

Příklad 2: Nastavení informací pro rozšíření vlastních skriptů virtuálního počítače pomocí cesty k souboru

PS C:\> Set-AzureVMCustomScriptExtension -VM $VM -FileUri "http://www.blob.core.contoso.net/bar/script1.ps1","http://www.blob.core.contoso.net/baz/script2.ps1" -Run "script1.ps1" -Argument "arg1 arg2";
PS C:\> Update-AzureVM -ServiceName $SVC -Name $Name -VM VM;

Tento příkaz nastaví informace o rozšíření vlastních skriptů virtuálního počítače pomocí více adres URL souborů.

Parametry

-Argument

Určuje řetězec, který poskytuje argument, který tato rutina spouští na virtuálním počítači.

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

-ContainerName

Určuje název kontejneru v rámci účtu úložiště.

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

-Disable

Označuje, že tato rutina zakáže stav rozšíření.

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

-FileName

Určuje pole řetězců, které obsahuje názvy souborů objektů blob v zadaném kontejneru.

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

-FileUri

Určuje pole řetězců, které obsahuje adresy URL souborů objektů blob.

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

-ForceUpdate

Označuje, že tato rutina znovu použije konfiguraci na rozšíření, pokud konfigurace nebyla aktualizována.

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

-InformationAction

Určuje, jak tato rutina reaguje na informační událost.

Tento parametr přijímá tyto hodnoty:

  • Pokračovat
  • Ignorovat
  • Informovat se
  • SilentlyContinue
  • Zastavit
  • Suspend
Typ:ActionPreference
Aliasy:infa
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InformationVariable

Určuje informační proměnnou.

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

-Profile

Určuje profil Azure, ze kterého se tato rutina čte. Pokud nezadáte profil, tato rutina načte z místního výchozího profilu.

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

-ReferenceName

Určuje název odkazu pro rozšíření.

Tento parametr je uživatelem definovaný řetězec, který lze použít k odkazování na rozšíření. Určuje se při prvním přidání rozšíření do virtuálního počítače. V případě následných aktualizací musíte při aktualizaci rozšíření zadat dříve použitý název odkazu. ReferenceName přiřazené k rozšíření se vrátí pomocí rutiny Get-AzureVM.

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

-Run

Určuje příkaz, který tato rutina spustí rozšířením na virtuálním počítači. Podporuje se jenom powershell.exe.

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

-StorageAccountKey

Určuje klíč účtu úložiště.

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

-StorageAccountName

Určuje název účtu úložiště v aktuálním předplatném.

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

-StorageEndpointSuffix

Určuje koncový bod služby úložiště.

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

-Uninstall

Označuje, že tato rutina odinstaluje rozšíření vlastních skriptů z virtuálního počítače.

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

-Version

Určuje verzi rozšíření vlastních skriptů.

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

-VM

Určuje trvalý objekt virtuálního počítače.

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