Set-SCVMTemplate

構文

Set-SCVMTemplate
   [-VMTemplate] <Template>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile \<Boolean\>]
   [-DomainJoinCredential <VMMCredential>]
   [-AnswerFile <Script>]
   [-ApplicationProfile <ApplicationProfile>]
   [-SQLProfile <SQLProfile>]
   [-LinuxAdministratorSSHKey <SSHKey>]
   [-LinuxAdministratorSSHKeyString <String>]
   [-LinuxDomainName <String>]
   [-Owner <String>]
   [-OperatingSystem <OperatingSystem>]
   [-Enabled \<Boolean\>]
   [-HighlyAvailable \<Boolean\>]
   [-HAVMPriority <UInt32>]
   [-DRProtectionRequired \<Boolean\>]
   [-ReplicationGroup <ReplicationGroup>]
   [-SecureBootEnabled \<Boolean\>]
   [-NumLock \<Boolean\>]
   [-CPULimitFunctionality \<Boolean\>]
   [-CPULimitForMigration \<Boolean\>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-UpdateManagementProfile <AzureProfile>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-Domain <String>]
   [-DeploymentTypeNano \<Boolean\>]
   [-Workgroup <String>]
   [-CapabilityProfile <CapabilityProfile>]
   [-RemoveCapabilityProfile]
   [-UserRole <UserRole>]
   [-JobGroup <Guid>]
   [-QuotaPoint <UInt32>]
   [-CostCenter <String>]
   [-Tag <String>]
   [-Custom1 <String>]
   [-Custom2 <String>]
   [-Custom3 <String>]
   [-Custom4 <String>]
   [-Custom5 <String>]
   [-Custom6 <String>]
   [-Custom7 <String>]
   [-Custom8 <String>]
   [-Custom9 <String>]
   [-Custom10 <String>]
   [-BlockDynamicOptimization \<Boolean\>]
   [-ClearDRProtection]
   [-Description <String>]
   [-MemoryMB <Int32>]
   [-DynamicMemoryEnabled \<Boolean\>]
   [-DynamicMemoryMaximumMB <Int32>]
   [-DynamicMemoryBufferPercentage <Int32>]
   [-MemoryWeight <Int32>]
   [-VirtualVideoAdapterEnabled \<Boolean\>]
   [-MonitorMaximumCount <Int32>]
   [-MonitorMaximumResolution <String>]
   [-RecoveryPointObjective <Int32>]
   [-ProtectionProvider <ProtectionProvider>]
   [-BootOrder <BootDevice[]>]
   [-FirstBootDevice <String>]
   [-SecureBootTemplate <String>]
   [-CPUCount <Byte>]
   [-CPUType <ProcessorType>]
   [-CPUExpectedUtilizationPercent <Int32>]
   [-DiskIops <Int32>]
   [-NetworkUtilizationMbps <Int32>]
   [-CPURelativeWeight <Int32>]
   [-CPUReserve <Int32>]
   [-CPUMaximumPercent <Int32>]
   [-CPUPerVirtualNumaNodeMaximum <Byte>]
   [-MemoryPerVirtualNumaNodeMaximumMB <Int32>]
   [-VirtualNumaNodesPerSocketMaximum <Byte>]
   [-DynamicMemoryMinimumMB <Int32>]
   [-NumaIsolationRequired \<Boolean\>]
   [-AutomaticCriticalErrorAction <UInt16>]
   [-AutomaticCriticalErrorActionTimeout <Int32>]
   [-CheckpointType <CheckpointType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCVMTemplate
   [-VMTemplate] <Template>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile \<Boolean\>]
   [-DomainJoinCredential <VMMCredential>]
   [-AnswerFile <Script>]
   [-ApplicationProfile <ApplicationProfile>]
   [-SQLProfile <SQLProfile>]
   [-LinuxAdministratorSSHKey <SSHKey>]
   [-LinuxAdministratorSSHKeyString <String>]
   [-LinuxDomainName <String>]
   [-Owner <String>]
   [-OperatingSystem <OperatingSystem>]
   [-Enabled \<Boolean\>]
   [-HighlyAvailable \<Boolean\>]
   [-HAVMPriority <UInt32>]
   [-DRProtectionRequired \<Boolean\>]
   [-ReplicationGroup <ReplicationGroup>]
   [-SecureBootEnabled \<Boolean\>]
   [-NumLock \<Boolean\>]
   [-CPULimitFunctionality \<Boolean\>]
   [-CPULimitForMigration \<Boolean\>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-UpdateManagementProfile <AzureProfile>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-Domain <String>]
   [-DeploymentTypeNano \<Boolean\>]
   [-Workgroup <String>]
   [-CapabilityProfile <CapabilityProfile>]
   [-RemoveCapabilityProfile]
   [-UserRole <UserRole>]
   [-Name <String>]
   [-JobGroup <Guid>]
   [-QuotaPoint <UInt32>]
   [-CostCenter <String>]
   [-Tag <String>]
   [-Custom1 <String>]
   [-Custom2 <String>]
   [-Custom3 <String>]
   [-Custom4 <String>]
   [-Custom5 <String>]
   [-Custom6 <String>]
   [-Custom7 <String>]
   [-Custom8 <String>]
   [-Custom9 <String>]
   [-Custom10 <String>]
   [-BlockDynamicOptimization \<Boolean\>]
   [-ClearDRProtection]
   [-Description <String>]
   [-MemoryMB <Int32>]
   [-DynamicMemoryEnabled \<Boolean\>]
   [-DynamicMemoryMaximumMB <Int32>]
   [-DynamicMemoryBufferPercentage <Int32>]
   [-MemoryWeight <Int32>]
   [-VirtualVideoAdapterEnabled \<Boolean\>]
   [-MonitorMaximumCount <Int32>]
   [-MonitorMaximumResolution <String>]
   [-RecoveryPointObjective <Int32>]
   [-ProtectionProvider <ProtectionProvider>]
   [-BootOrder <BootDevice[]>]
   [-FirstBootDevice <String>]
   [-SecureBootTemplate <String>]
   [-CPUCount <Byte>]
   [-CPUType <ProcessorType>]
   [-CPUExpectedUtilizationPercent <Int32>]
   [-DiskIops <Int32>]
   [-NetworkUtilizationMbps <Int32>]
   [-CPURelativeWeight <Int32>]
   [-CPUReserve <Int32>]
   [-CPUMaximumPercent <Int32>]
   [-CPUPerVirtualNumaNodeMaximum <Byte>]
   [-MemoryPerVirtualNumaNodeMaximumMB <Int32>]
   [-VirtualNumaNodesPerSocketMaximum <Byte>]
   [-DynamicMemoryMinimumMB <Int32>]
   [-NumaIsolationRequired \<Boolean\>]
   [-AutomaticCriticalErrorAction <UInt16>]
   [-AutomaticCriticalErrorActionTimeout <Int32>]
   [-CheckpointType <CheckpointType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

説明

Set-SCVMTemplate コマンドレットは、Virtual Machine Manager (VMM) 環境で使用される仮想マシン テンプレートの 1 つ以上のプロパティを変更します。

変更できるプロパティには、テンプレートの名前、説明、所有者、組織名、タイム ゾーン、オペレーティング システム、プロダクト キーの設定が含まれます。BIOS ブート順序。CPU 番号と特性。仮想マシンに割り当てられているホスト上のメモリ量。仮想マシンで使用可能なホストのネットワーク上の帯域幅の量。このテンプレートで作成された仮想マシンが高可用性 (つまり、ホスト クラスターの一部であるホストにデプロイされる) かどうか。ドメインまたはワークグループおよびドメイン資格情報の値。セルフサービス ユーザーが作成できる新しい仮想マシンの数を指定するポイント クォータ。ユーザー設定フィールド。その他のオプション。

テンプレートに対して行った変更は、テンプレートにのみ影響します。 変更は、このテンプレートを使用して以前に作成された既存の仮想マシンには影響しません。

仮想ディスク ドライブ、仮想フロッピー ドライブ、仮想 DVD ドライブ、仮想ネットワーク アダプターのプロパティを変更する場合は、 特定のテンプレートに関連付けられている仮想 SCSI アダプターまたは仮想 COM ポート、Set-SCVirtualDiskDrive 、Set を使用できます -SCVirtualFloppyDrive、Set-SCVirtualDVDDrive、Set-SCVirtualNetworkAdapter、Set-SCVirtualScsiAdapter、または Set-SCVirtualCOMPort コマンドレット 、 それぞれ。

例

例 1: 既存の仮想マシン テンプレートのメモリ量を指定する

PS C:\> $Template = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> Set-SCVMTemplate -Template $Template -MemoryMB 1024

最初のコマンドは、VMM ライブラリから VMTemplate01 という名前の仮想マシン テンプレート オブジェクトを取得し、そのオブジェクトを $Template 変数に格納します。

2 番目のコマンドは、VMTemplate01 のメモリ値を 1024 MB に変更します。 これは、このテンプレートを使用して作成された仮想マシンが使用するホスト上のメモリ量です。

例 2: 複数の高可用性仮想マシン テンプレートの新しい所有者を指定する

PS C:\> $VMTemplates = Get-SCVMTemplate | where {$_.IsHighlyAvailable}
PS C:\> ForEach ($VMTemplate in $VMTemplates) {Set-SCVMTemplate $VMTemplate -Owner "Contoso\NevenSokec"}

最初のコマンドは、高可用性のすべての仮想マシン テンプレート オブジェクトを取得し、オブジェクトを $VMTemplates オブジェクト配列に格納します。

2 番目のコマンドでは、ForEach ループを使用して、$VMTemplates配列内の各テンプレートの新しい所有者を指定します。

標準の PowerShell ForEach ループ ステートメントの詳細については、「Get-Help about_ForEach」と入力します。

例 3: 同じ所有者を持つすべての仮想マシン テンプレートに新しい所有者を指定する

PS C:\> Get-SCVMTemplate -VMMServer "VMMServer01.Contoso.com" | where {$_.Owner -eq "Contoso\PattiFuller"} | Set-SCVMTemplate -Owner "Contoso\AllieSloan"

このコマンドは、VMM ライブラリからすべての仮想マシン テンプレート オブジェクトを取得し、所有者が "Contoso\PattiFuller" であるオブジェクトのみを選択し、各オブジェクトを Set-SCVMTemplate コマンドレットに渡します。これにより、所有者が Contoso|AllieSloan。

例 4: 既存の仮想マシン テンプレートの動的メモリを有効にする

PS C:\> $VMTemplate = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate04"}
PS C:\> Set-SCVMTemplate -VMTemplate $VMTemplate -DynamicMemoryEnabled $True -MemoryMB 1024 -DynamicMemoryMaximumMB 2048

最初のコマンドは、VMM ライブラリから VMTemplate04 という名前の仮想マシン テンプレート オブジェクトを取得し、そのオブジェクトを $VMTemplate 変数に格納します。

2 番目のコマンドでは、動的メモリを有効にし、VMTemplate04 のスタートアップ メモリ値を 1024 MB に変更し (これは、このテンプレートを使用して作成された仮想マシンが起動時に割り当てられるホスト上のメモリ量です)、最大メモリ値を 2048 MB に設定します (これは、このテンプレートを使用して作成された仮想マシンに割り当てることができる最大メモリ量です)。 動的メモリを使用する仮想マシンは、Windows Server 2008 R2 SP1 以降を実行しているホストにのみ展開できます。

例 5: 既存のカスタマイズ可能な Linux 仮想マシン テンプレートのルート パスワードを指定する

PS C:\> $Template = Get-SCVMTemplate | where {$_.Name -eq "LinuxVMTemplate01"}
PS C:\> $Creds = Get-Credential
PS C:\> Set-SCVMTemplate -Template $Template -LocalAdministratorCredential $Creds

最初のコマンドは、VMM ライブラリから LinuxVMTemplate01 という名前の仮想マシン テンプレート オブジェクトを取得し、そのオブジェクトを $Template 変数に格納します。

2 番目のコマンドは、Get-Credential コマンドを使用してユーザー名 (ルート) とパスワードを取得し、結果を $Creds 変数に格納します。

最後のコマンドは、ルート アカウントのパスワードを、$Creds変数に格納されているパスワードに設定します。

例 6: 既存の VM テンプレートで Azure Update 管理機能を有効にする。

PS C:\> $Template = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> $azureProfile = Get-SCAzureProfile | where { $_.Name -eq "AzUpdateMgmtProfile"}
PS C:\> Set-SCVMTemplate -Template $Template -UpdateManagementProfile $azureProfile

最初のコマンドは、VMM ライブラリから VMTemplate01 という名前の仮想マシン テンプレート オブジェクトを取得し、そのオブジェクトを $Template 変数に格納します。

2 番目のコマンドは、VMM ライブラリから Azure 更新管理プロファイルを取得し、$azureProfile変数にオブジェクトを格納します。

3 番目のコマンドでは、Azure プロファイルをリンクすることで、Azure Update 管理機能を使用してテンプレートを有効にします。

例 7: VM テンプレートで Azure Update 管理機能を無効にする。

PS C:\> $Template = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> Set-SCVMTemplate -Template $Template -UpdateManagementProfile $null

最初のコマンドは、VMM ライブラリから VMTemplate01 という名前の仮想マシン テンプレート オブジェクトを取得し、そのオブジェクトを $Template 変数に格納します。

2 番目のコマンドでは、Azure Update 管理機能を使用してテンプレートを無効にします。

パラメーター

-AnswerFile

-ApplicationProfile

-AutoLogonCount

-AutoLogonCredential

-AutomaticCriticalErrorAction

-AutomaticCriticalErrorActionTimeout

-BlockDynamicOptimization

-BootOrder

-CapabilityProfile

-CheckpointType

-ClearDRProtection

-ComputerName

-CostCenter

-CPUCount

-CPUExpectedUtilizationPercent

-CPULimitForMigration

-CPULimitFunctionality

-CPUMaximumPercent

-CPUPerVirtualNumaNodeMaximum

-CPURelativeWeight

-CPUReserve

-CPUType

-Custom1

-Custom10

-Custom2

-Custom3

-Custom4

-Custom5

-Custom6

-Custom7

-Custom8

-Custom9

-DeploymentTypeNano

-Description

-DisableAutoLogon

-DiskIops

-Domain

-DomainJoinCredential

-DomainJoinOrganizationalUnit

-DRProtectionRequired

-DynamicMemoryBufferPercentage

-DynamicMemoryEnabled

-DynamicMemoryMaximumMB

-DynamicMemoryMinimumMB

-Enabled

-EnableNestedVirtualization

-FirstBootDevice

-FullName

-GuiRunOnceCommands

-HAVMPriority

-HighlyAvailable

-JobGroup

-JobVariable

-LinuxAdministratorSSHKey

-LinuxAdministratorSSHKeyString

-LinuxDomainName

-LocalAdministratorCredential

-MemoryMB

-MemoryPerVirtualNumaNodeMaximumMB

-MemoryWeight

-MergeAnswerFile

-MonitorMaximumCount

-MonitorMaximumResolution

-Name

-NetworkUtilizationMbps

-NumaIsolationRequired

-NumLock

-OperatingSystem

-OrganizationName

-Owner

-ProductKey

-ProtectionProvider

-PROTipID

-QuotaPoint

-RecoveryPointObjective

-RemoveCapabilityProfile

-RemoveDomainJoinOrganizationalUnit

-RemoveServerFeatures

-ReplicationGroup

-RunAsynchronously

-SecureBootEnabled

-SecureBootTemplate

-SQLProfile

-Tag

-TimeZone

-UnattendSettings

-UpdateManagementProfile

-UserRole

-VirtualNumaNodesPerSocketMaximum

-VirtualVideoAdapterEnabled

-VMTemplate

-Workgroup

出力

Template

このコマンドレットは、Template オブジェクトを返します。

メモ

• Get-SCVMTemplate コマンドレットを使用して取得できる VMM 仮想マシン テンプレート オブジェクトが必要です。

関連リンク

• Get-SCVMTemplate
• New-SCVMTemplate
• Remove-SCVMTemplate