Add-AzureRmVMAdditionalUnattendContent
無人 Windows セットアップ応答ファイルに情報を追加します。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
Add-AzureRmVMAdditionalUnattendContent
[-VM] <PSVirtualMachine>
[[-Content] <String>]
[[-SettingName] <SettingNames>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
Add-AzureRmVMAdditionalUnattendContent コマンドレットは、無人 Windows セットアップ応答ファイルに情報を追加します。 このコマンドレットがunattend.xml ファイルに追加する、追加の base 64 でエンコードされた.xml形式の情報を指定します。
例
例 1: unattend.xmlにコンテンツを追加する
PS C:\> $AvailabilitySet = Get-AzureRmAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
PS C:\> $Credential = Get-Credential
PS C:\> $VirtualMachine = Set-AzureRmVMOperatingSystem -VM $VirtualMachine -Windows -ComputerName "Contoso26" -Credential $Credential
PS C:\> $AucContent = "<UserAccounts><AdministratorPassword><Value>" + "Password" + "</Value><PlainText>true</PlainText></AdministratorPassword></UserAccounts>";
PS C:\> $VirtualMachine = Add-AzureRmVMAdditionalUnattendContent -VM $VirtualMachine -Content $AucContent -SettingName "AutoLogon"
最初のコマンドは、ResourceGroup11 という名前のリソース グループ内の AvailabilitablitySet03 という名前の可用性セットを取得し、そのオブジェクトを $AvailabilitySet 変数に格納します。
2 番目のコマンドは、仮想マシン オブジェクトを作成し、$VirtualMachine変数に格納します。
このコマンドは、仮想マシンに名前とサイズを割り当てます。
仮想マシンは、$AvailabilitySetに格納されている可用性セットに属しています。
3 番目のコマンドは、Get-Credential コマンドレットを使用して資格情報オブジェクトを作成し、結果を $Credential 変数に格納します。
コマンドによって、ユーザー名とパスワードの入力が求められます。
詳細を表示するには「Get-Help Get-Credential
」を入力します。
4 番目のコマンドでは、 Set-AzureRmVMOperatingSystem コマンドレットを使用して、$VirtualMachineに格納されている仮想マシンを構成します。
5 番目のコマンドは、$AucContent変数にコンテンツを割り当てます。
コンテンツにはパスワードが含まれています。
最後のコマンドは、$AucContentに格納されているコンテンツをunattend.xml ファイルに追加します。
パラメーター
-Content
Base 64 でエンコードされた XML 形式のコンテンツを指定します。 このコマンドレットは、unattend.xml ファイルにコンテンツを追加します。 XML コンテンツは 4 KB (キロバイト)未満である必要があり、このコマンドレットが挿入する設定または機能のルート要素を含める必要があります。
型: | String |
配置: | 1 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
型: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SettingName
コンテンツが適用される設定の名前を指定します。 このパラメーターの有効値は、次のとおりです。
- FirstLogonCommands
- 自動ログオン
型: | Nullable<T>[SettingNames] |
指定可能な値: | AutoLogon, FirstLogonCommands |
配置: | 2 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-VM
このコマンドレットが変更する仮想マシン オブジェクトを指定します。 仮想マシン オブジェクトを取得するには、Get-AzureRmVM コマンドレットを使用します。 New-AzureRmVMConfig コマンドレットを使用して仮想マシン オブジェクトを作成します。
型: | PSVirtualMachine |
Aliases: | VMProfile |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
入力
Nullable<T>[[Microsoft.Azure.Management.Compute.Models.SettingNames, Microsoft.Azure.Management.Compute, Version=21.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]