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.

Syntax

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
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:True
Accept wildcard characters:False

-ContainerName

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

Typ:String
Position:2
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:True
Accept wildcard characters:False

-Disable

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

Typ:SwitchParameter
Position:2
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:True
Accept wildcard characters:False

-FileName

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

Typ:String[]
Position:3
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:True
Accept wildcard characters:False

-FileUri

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

Typ:String[]
Position:2
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:True
Accept wildcard characters:False

-ForceUpdate

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

Typ:SwitchParameter
Position:9
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters: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
Aliases:infa
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Určuje informační proměnnou.

Typ:String
Aliases:iv
Position:Named
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters: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
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:False
Accept wildcard characters: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
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:True
Accept wildcard characters: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
Aliases:RunFile, Command
Position:7
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountKey

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

Typ:String
Position:6
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageAccountName

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

Typ:String
Position:4
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:True
Accept wildcard characters:False

-StorageEndpointSuffix

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

Typ:String
Position:5
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:True
Accept wildcard characters:False

-Uninstall

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

Typ:SwitchParameter
Position:2
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:True
Accept wildcard characters:False

-Version

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

Typ:String
Position:1
výchozí hodnota:None
Vyžadováno:False
Accept pipeline input:True
Accept wildcard characters:False

-VM

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

Typ:IPersistentVM
Aliases:InputObject
Position:Named
výchozí hodnota:None
Vyžadováno:True
Accept pipeline input:True
Accept wildcard characters:False