Add-AzVMAdditionalUnattendContent

  • リファレンス
モジュール:
Az.Compute

無人 Windows セットアップ応答ファイルに情報を追加します。

構文

Add-AzVMAdditionalUnattendContent
   [-VM] <PSVirtualMachine>
   [[-Content] <String>]
   [[-SettingName] <SettingNames>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

説明

Add-AzVMAdditionalUnattendContent コマンドレットは、無人 Windows セットアップ応答ファイルに情報を追加します。 このコマンドレットがunattend.xml ファイルに追加する、追加の base 64 でエンコードされた.xml形式の情報を指定します。

例

例 1: unattend.xmlにコンテンツを追加する

$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id 
$Credential = Get-Credential
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine  -Windows -ComputerName "Contoso26" -Credential $Credential
$AucContent = "<UserAccounts><AdministratorPassword><Value>" + "Password" + "</Value><PlainText>true</PlainText></AdministratorPassword></UserAccounts>";
$VirtualMachine = Add-AzVMAdditionalUnattendContent -VM $VirtualMachine -Content $AucContent -SettingName "AutoLogon"

最初のコマンドは、ResourceGroup11 という名前のリソース グループ内の AvailabilitySet03 という名前の可用性セットを取得し、そのオブジェクトを $AvailabilitySet 変数に格納します。 2 番目のコマンドは、仮想マシン オブジェクトを作成し、$VirtualMachine変数に格納します。 このコマンドは、仮想マシンに名前とサイズを割り当てます。 仮想マシンは、$AvailabilitySetに格納されている可用性セットに属しています。 3 番目のコマンドは、Get-Credential コマンドレットを使用して資格情報オブジェクトを作成し、結果を $Credential 変数に格納します。 コマンドによって、ユーザー名とパスワードの入力が求められます。 詳細を表示するには「Get-Help Get-Credential」を入力します。 4 番目のコマンドでは、 Set-AzVMOperatingSystem コマンドレットを使用して、$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:AzContext, 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-AzVM コマンドレットを使用します。 New-AzVMConfig コマンドレットを使用して仮想マシン オブジェクトを作成します。

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=23.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

出力

PSVirtualMachine