Set-AzureVMCustomScriptExtension
設定 Azure 虛擬機器自訂腳本擴充功能的資訊。
注意
本檔中參考的 Cmdlet 用於管理使用服務管理 API 的舊版 Azure 資源。 如需管理 Azure Resource Manager 資源的 Cmdlet，請參閱 Az PowerShell 模組 。
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
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 在虛擬機器上執行的引數。
| Type: | String |
| Position: | 8 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ContainerName
指定儲存體帳戶內的容器名稱。
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Disable
表示此 Cmdlet 會停用擴充功能狀態。
| Type: | SwitchParameter |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-FileName
指定字串陣列，其中包含指定容器中 Blob 檔案的名稱。
| Type: | String[] |
| Position: | 3 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-FileUri
指定包含 Blob 檔案 URL 的字串陣列。
| Type: | String[] |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ForceUpdate
指出當設定尚未更新時，此 Cmdlet 會將組態重新套用至擴充功能。
| Type: | SwitchParameter |
| Position: | 9 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InformationAction
指定此 Cmdlet 如何回應資訊事件。
此參數可接受的值為：
- 繼續
- 忽略
- 詢問
- SilentlyContinue
- 停止
- 暫止
| Type: | ActionPreference |
| Aliases: | infa |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InformationVariable
指定資訊變數。
| Type: | String |
| Aliases: | iv |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Profile
指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔，此 Cmdlet 會從本機預設設定檔讀取。
| Type: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReferenceName
指定延伸模組的參考名稱。
此參數是使用者定義字串，可用來參考延伸模組。 第一次將擴充功能新增至虛擬機器時，會指定此擴充功能。 針對後續更新，您必須在更新延伸模組時指定先前使用的參考名稱。 指派給擴充功能的 ReferenceName 會使用 Get-AzureVM Cmdlet 傳回。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Run
指定這個 Cmdlet 在虛擬機器上由擴充功能執行的命令。 僅支援 「powershell.exe」。
| Type: | String |
| Aliases: | RunFile, Command |
| Position: | 7 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StorageAccountKey
指定儲存體帳戶金鑰
| Type: | String |
| Position: | 6 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StorageAccountName
指定目前訂用帳戶中的儲存體帳戶名稱。
| Type: | String |
| Position: | 4 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StorageEndpointSuffix
指定儲存體服務端點。
| Type: | String |
| Position: | 5 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Uninstall
指出此 Cmdlet 會從虛擬機器卸載自訂腳本擴充功能。
| Type: | SwitchParameter |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Version
指定自訂腳本擴充功能的版本。
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VM
指定持續性虛擬機器物件。
| Type: | IPersistentVM |
| Aliases: | InputObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |