Add-AzureRmVMAdditionalUnattendContent

リファレンス

モジュール:: AzureRM.Compute

無人 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 (キロバイト)未満である必要があり、このコマンドレットが挿入する設定または機能のルート要素を含める必要があります。

Type:	String
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SettingName

コンテンツが適用される設定の名前を指定します。このパラメーターの有効値は、次のとおりです。

FirstLogonCommands
自動ログオン

Type:	Nullable<T>[SettingNames]
Accepted values:	AutoLogon, FirstLogonCommands
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-VM

このコマンドレットが変更する仮想マシンオブジェクトを指定します。仮想マシンオブジェクトを取得するには、Get-AzureRmVM コマンドレットを使用します。 New-AzureRmVMConfig コマンドレットを使用して仮想マシンオブジェクトを作成します。

Type:	PSVirtualMachine
Aliases:	VMProfile
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

入力

PSVirtualMachine

String

Nullable<T>[[Microsoft.Azure.Management.Compute.Models.SettingNames, Microsoft.Azure.Management.Compute, Version=21.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

出力