Set-AzureVMCustomScriptExtension
設定 Azure 虛擬機自定義腳本擴充功能的資訊。
注意
本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager（ASM） API 的舊版 Azure 資源。 建立新的資源時，不建議使用此舊版 PowerShell 模組，因為 ASM 已排定淘汰。 如需詳細資訊，請參閱 Azure Service Manager 淘汰。
Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager （ARM） 資源的建議 PowerShell 模組。
語法
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
Set-AzureVMCustomScriptExtension Cmdlet 會設定 Azure 虛擬機自定義腳本擴充功能的資訊。
範例
範例 1：設定虛擬機自定義腳本擴充功能的資訊
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;此命令會設定虛擬機自定義腳本擴充功能的資訊。
範例 2：使用檔案路徑設定虛擬機自定義腳本延伸模塊的資訊
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;此命令會使用多個檔案 URL 來設定虛擬機自定義腳本延伸模組的資訊。
參數
-Argument
指定字串，提供這個 Cmdlet 在虛擬機上執行的自變數。
| 類型: | String |
| Position: | 8 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ContainerName
指定記憶體帳戶內的容器名稱。
| 類型: | String |
| Position: | 2 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Disable
表示此 Cmdlet 會停用擴充功能狀態。
| 類型: | SwitchParameter |
| Position: | 2 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-FileName
指定字串陣列，其中包含指定容器中 Blob 檔案的名稱。
| 類型: | String[] |
| Position: | 3 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-FileUri
指定包含 Blob 檔案 URL 的字串陣列。
| 類型: | String[] |
| Position: | 2 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ForceUpdate
指出當設定尚未更新時，此 Cmdlet 會將組態重新套用至擴充功能。
| 類型: | SwitchParameter |
| Position: | 9 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-InformationAction
指定此 Cmdlet 如何回應資訊事件。
此參數可接受的值為：
- 繼續
- 忽略
- 詢問
- SilentlyContinue
- 停止
- 暫止
| 類型: | ActionPreference |
| 別名: | infa |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-InformationVariable
指定資訊變數。
| 類型: | String |
| 別名: | iv |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Profile
指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔，此 Cmdlet 會從本機預設配置檔讀取。
| 類型: | AzureSMProfile |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ReferenceName
指定延伸模組的參考名稱。
此參數是使用者定義字串，可用來參考延伸模組。 第一次將擴充功能新增至虛擬機時，會指定此擴充功能。 針對後續更新，您必須在更新延伸模組時指定先前使用的參考名稱。 指派給擴充功能的 ReferenceName 會使用 Get-AzureVM Cmdlet 傳回。
| 類型: | String |
| Position: | 0 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Run
指定這個 Cmdlet 在虛擬機上由擴充功能執行的命令。 僅支援「powershell.exe」。
| 類型: | String |
| 別名: | RunFile, Command |
| Position: | 7 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-StorageAccountKey
指定記憶體帳戶金鑰
| 類型: | String |
| Position: | 6 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-StorageAccountName
指定目前訂用帳戶中的記憶體帳戶名稱。
| 類型: | String |
| Position: | 4 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-StorageEndpointSuffix
指定記憶體服務端點。
| 類型: | String |
| Position: | 5 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Uninstall
指出此 Cmdlet 會從虛擬機卸載自定義腳本擴充功能。
| 類型: | SwitchParameter |
| Position: | 2 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Version
指定自定義腳本擴充功能的版本。
| 類型: | String |
| Position: | 1 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-VM
指定持續性虛擬機物件。
| 類型: | IPersistentVM |
| 別名: | InputObject |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |