Set-AzureVMExtension
仮想マシンのリソース拡張機能を設定します。
注意
このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az PowerShell モジュールを参照してください。
構文
Set-AzureVMExtension
[-ExtensionName] <String>
[-Publisher] <String>
[-Version] <String>
[[-ReferenceName] <String>]
[[-PublicConfiguration] <String>]
[[-PrivateConfiguration] <String>]
[-Disable]
[-Uninstall]
[[-PublicConfigKey] <String>]
[[-PrivateConfigKey] <String>]
[-ForceUpdate]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Set-AzureVMExtension
[-ExtensionName] <String>
[-Publisher] <String>
[-Version] <String>
[[-ReferenceName] <String>]
[[-PublicConfigPath] <String>]
[[-PrivateConfigPath] <String>]
[-Disable]
[-Uninstall]
[[-PublicConfigKey] <String>]
[[-PrivateConfigKey] <String>]
[-ForceUpdate]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Set-AzureVMExtension
[-ReferenceName] <String>
[[-PublicConfiguration] <String>]
[[-PrivateConfiguration] <String>]
[-Disable]
[-Uninstall]
[[-PublicConfigKey] <String>]
[[-PrivateConfigKey] <String>]
[-ForceUpdate]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Set-AzureVMExtension
[-ReferenceName] <String>
[[-PublicConfigPath] <String>]
[[-PrivateConfigPath] <String>]
[-Disable]
[-Uninstall]
[[-PublicConfigKey] <String>]
[[-PrivateConfigKey] <String>]
[-ForceUpdate]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] 説明
Set-AzureVMExtension コマンドレットは、仮想マシンのリソース拡張機能を設定します。
例
例 1: リソース拡張機能が適用された仮想マシンを作成する
PS C:\> $X = New-AzureVMConfig -Name $VM -InstanceSize Small -ImageName $IMG;$X = Add-AzureProvisioningConfig -VM $X -Password $PWD -AdminUsername $USR -Windows;$X = Set-AzureVMExtension -VM $X -ExtensionName $Ext1 -Publisher $Publisher -Version $VER -PublicConfiguration $P1 -PrivateConfiguration $P2;$X = Set-AzureVMExtension -VM $X -ExtensionName $Ext2 -Publisher $Publisher -Version $VER -PublicConfiguration $P3 -PrivateConfiguration $P4;New-AzureVM -Location $LOC -ServiceName $SVC -VM $X;このコマンドを実行すると、リソース拡張機能が適用された仮想マシンが作成されます。
パラメーター
-Disable
このコマンドレットが拡張機能の状態を無効にすることを示します。
| Type: | SwitchParameter |
| Position: | 7 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ExtensionName
仮想マシンの拡張機能名を指定します。
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ForceUpdate
構成が更新されていない場合に、このコマンドレットによって拡張機能に構成が再適用されることを示します。
| Type: | SwitchParameter |
| Position: | 11 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InformationAction
このコマンドレットが情報イベントに応答する方法を指定します。
このパラメーターの有効値は、次のとおりです。
- 続行
- Ignore
- Inquire
- SilentlyContinue
- Stop
- Suspend
| 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 |
-PrivateConfigKey
秘密構成キーを指定します。
| Type: | String |
| Position: | 10 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PrivateConfigPath
プライベート構成パスを指定します。
| Type: | String |
| Position: | 6 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PrivateConfiguration
プライベート構成テキストを指定します。
| Type: | String |
| Position: | 6 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
| Type: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PublicConfigKey
公開構成キーを指定します。
| Type: | String |
| Position: | 9 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PublicConfigPath
パブリック構成パスを指定します。
| Type: | String |
| Position: | 5 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PublicConfiguration
パブリック構成テキストを指定します。
| Type: | String |
| Position: | 5 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Publisher
拡張機能の発行元を指定します。
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ReferenceName
拡張機能の参照名を指定します。
これは、拡張機能を参照するために使用できるユーザー定義の文字列です。 拡張機能を仮想マシンに初めて追加するときに指定する必要があります。 以降の更新では、拡張機能の更新中に以前に使用した参照名を指定する必要があります。 拡張機能に割り当てられた ReferenceName は、Get-AzureVM コマンドレットを使用して返されます。
| Type: | String |
| Position: | 4 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Uninstall
このコマンドレットが仮想マシンからリソース拡張機能をアンインストールすることを示します。
| Type: | SwitchParameter |
| Position: | 8 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Version
拡張機能のバージョンを指定します。
| Type: | String |
| Position: | 3 |
| Default value: | None |
| Required: | True |
| 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 |