Set-AzureRmVmssOsProfile

VMSS オペレーティング システム プロファイルのプロパティを設定します。

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

Set-AzureRmVmssOsProfile
   [-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>
   [[-ComputerNamePrefix] <String>]
   [[-AdminUsername] <String>]
   [[-AdminPassword] <String>]
   [[-CustomData] <String>]
   [[-WindowsConfigurationProvisionVMAgent] <Boolean>]
   [[-WindowsConfigurationEnableAutomaticUpdate] <Boolean>]
   [[-TimeZone] <String>]
   [[-AdditionalUnattendContent] <AdditionalUnattendContent[]>]
   [[-Listener] <WinRMListener[]>]
   [[-LinuxConfigurationDisablePasswordAuthentication] <Boolean>]
   [[-PublicKey] <SshPublicKey[]>]
   [[-Secret] <VaultSecretGroup[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-AzureRmVmssOsProfile コマンドレットは、仮想マシン スケール セットのオペレーティング システム プロファイルプロパティを設定します。

例 1: VMSS のオペレーティング システム プロファイルのプロパティを設定する

PS C:\> Set-AzureRmVmssOSProfile -VirtualMachineScaleSet "ContosoVMSS" -ComputerNamePrefix "Test" -AdminUsername $AdminUsername -AdminPassword $AdminPassword

このコマンドは、ContosoVMSS という名前の VMSS に属する仮想マシンのオペレーティング システム プロファイル プロパティを設定します。 このコマンドは、VMSS 内のすべての仮想マシン インスタンスのコンピューター名プレフィックスをテストに設定し、管理者のユーザー名とパスワードを指定します。

パラメーター

-AdditionalUnattendContent

無人コンテンツ オブジェクトを指定します。 Add-AzureRmVMAdditionalUnattendContent を使用してオブジェクトを作成できます。

Type:AdditionalUnattendContent[]
Position:8
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AdminPassword

VMSS 内のすべての仮想マシン インスタンスに使用する管理者パスワードを指定します。

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

-AdminUsername

VMSS 内のすべての仮想マシン インスタンスに使用する管理者アカウント名を指定します。

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

-ComputerNamePrefix

VMSS 内のすべての仮想マシン インスタンスのコンピューター名プレフィックスを指定します。 コンピューター名の長さは 1 ~ 15 文字にする必要があります。

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

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CustomData

カスタム データの base-64 でエンコードされた文字列を指定します。 これは、仮想マシン上のファイルとして保存されるバイナリ配列にデコードされます。 バイナリ配列の最大長は 65535 バイトです。

Type:String
Position:4
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

-LinuxConfigurationDisablePasswordAuthentication

このコマンドレットがパスワード認証を無効にすることを示します。

Type:Nullable<T>[Boolean]
Position:10
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Listener

Windows リモート管理 (WinRM) リスナーを指定します。 これにより、リモート Windows PowerShell が有効になります。 Add-AzureRmVmssWinRMListener コマンドレットを使用してリスナーを作成できます。

Type:WinRMListener[]
Position:9
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PublicKey

Secure Shell (SSH) 公開キー オブジェクトを指定します。 Add-AzureRmVMSshPublicKey コマンドレットを使用して、オブジェクトを作成できます。

Type:SshPublicKey[]
Position:11
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Secret

仮想マシンに配置する証明書参照を含むシークレット オブジェクトを指定します。 Add-AzureRmVmssSecret コマンドレットを使用してシークレット オブジェクトを作成できます。

Type:VaultSecretGroup[]
Position:12
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TimeZone

仮想マシンのタイム ゾーンを指定します。

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

-VirtualMachineScaleSet

VMSS オブジェクトを指定します。 New-AzureRmVmssConfig コマンドレットを使用してオブジェクトを作成できます。

Type:PSVirtualMachineScaleSet
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WindowsConfigurationEnableAutomaticUpdate

VMSS 内の仮想マシンが自動更新に対して有効になっているかどうかを示します。

Type:Nullable<T>[Boolean]
Position:6
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WindowsConfigurationProvisionVMAgent

VMSS 内の仮想マシンに仮想マシン エージェントをプロビジョニングする必要があるかどうかを示します。

Type:Nullable<T>[Boolean]
Position:5
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

入力

PSVirtualMachineScaleSet

String

Nullable<T>[[System.Boolean, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

AdditionalUnattendContent[]

WinRMListener[]

SshPublicKey[]

VaultSecretGroup[]

出力

PSVirtualMachineScaleSet