New-SCGuestOSProfile

モジュール:

VirtualMachineManager

VMM で使用するゲスト オペレーティング システム プロファイルを作成します。

構文

New-SCGuestOSProfile
   [-Shielded <Boolean>]
   [-GuiRunOnceCommands <String[]>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-ProductKey <String>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-GuestOSProfile <GuestOSProfile>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-LinuxDomainName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCGuestOSProfile
   [-Shielded <Boolean>]
   [-GuiRunOnceCommands <String[]>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxAdministratorSSHKey <SSHKey>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-ProductKey <String>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-GuestOSProfile <GuestOSProfile>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-LinuxDomainName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCGuestOSProfile
   [-Shielded <Boolean>]
   [-GuiRunOnceCommands <String[]>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxAdministratorSSHKeyString <String>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-ProductKey <String>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-GuestOSProfile <GuestOSProfile>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-LinuxDomainName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCGuestOSProfile
   [-Shielded <Boolean>]
   [-GuiRunOnceCommands <String[]>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-ProductKey <String>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   -Domain <String>
   [-DeploymentTypeNano <Boolean>]
   [-DomainJoinCredential <VMMCredential>]
   [-GuestOSProfile <GuestOSProfile>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-LinuxDomainName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCGuestOSProfile
   [-Shielded <Boolean>]
   [-GuiRunOnceCommands <String[]>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-ProductKey <String>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-Workgroup <String>]
   [-GuestOSProfile <GuestOSProfile>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-LinuxDomainName <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

説明

New-SCGuestOSProfile コマンドレットは、Virtual Machine Manager (VMM) で使用するゲスト オペレーティング システム プロファイルを作成します。 ゲスト オペレーティング システムとは、1 つ以上の仮想マシンが展開されている物理ホスト コンピューター上にあるホスト オペレーティング システムとは対照的に、仮想マシン上のオペレーティング システムです。

ゲスト オペレーティング システム プロファイルには、オペレーティング システムの構成情報が保管されます。 プロファイルは、無人応答ファイル (Sysprep.inf や Unattend.xml ファイルなど) で指定される最も一般的な設定を含むプロパティのセットで構成されます。

スタンドアロンのゲスト オペレーティング システム プロファイルを作成するか、テンプレートまたは仮想マシンをカスタマイズしてゲスト オペレーティング システム プロファイルの設定を含めることができます。 New-SCGuestOSProfile コマンドレットは、VMM ライブラリに新しいゲスト オペレーティング システム プロファイル オブジェクトを格納します。

ゲスト オペレーティング システム プロファイルは、既定の設定に基づいて、または既存のゲスト オペレーティング システム プロファイルに基づいて作成できます。また、プロファイルの作成時に設定をカスタマイズできます。 Name パラメーター以外のパラメーターを指定しない場合、 New-SCGuestOSProfile コマンドレットは既定のゲスト オペレーティング システム プロファイル オブジェクトを作成します。

例

例 1: 既定のゲスト オペレーティング システム プロファイルを作成する

PS C:\> $OS = Get-SCOperatingSystem -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "64-bit edition of Windows Server 2008 R2 Enterprise"}
PS C:\> New-SCGuestOSProfile -Name "NewOSProfile01" -OperatingSystem $OS

最初のコマンドは、VMMServer01 から "Windows Server 2008 R2 Enterprise の 64 ビット エディション" という名前のオペレーティング システム オブジェクトを取得し、そのオブジェクトを$OS変数に格納します。

2 番目のコマンドは、NewProfile01 という名前の既定のゲスト オペレーティング システム プロファイルを作成し、オペレーティング システムの名前を指定します。

例 2: 仮想マシンをドメインに参加させるために使用するゲスト オペレーティング システム プロファイルを作成する

PS C:\> $DomainCredential = Get-SCRunAsAccount -Name "RunAsAccount01"
PS C:\> $OS = Get-SCOperatingSystem -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "64-bit edition of Windows Server 2008 R2 Enterprise"} 
PS C:\> New-SCGuestOSProfile -Name "NewOSProfile02" -JoinDomain "Contoso.com" -DomainJoinCredential $DomainCredential -OperatingSystem $OS

最初のコマンドは、RunAsAccount01 という名前の実行アカウント オブジェクトを取得し、$DomainCredential変数にオブジェクトを格納します。

2 番目のコマンドは、VMMServer01 から Windows Server 2008 R2 Enterprise の 64 ビット エディションという名前のオペレーティング システム オブジェクトを取得し、$OS変数にオブジェクトを格納します。

最後のコマンドは、NewOSProfile02 という名前のゲスト オペレーティング システム プロファイルを作成し、オペレーティング システムの名前を指定します。 NewOSProfile02 を使用して仮想マシンを作成すると、プロファイルは指定された実行アカウントを使用して、仮想マシンを Contoso.com ドメインに参加させます。

注: DomainJoinCredential パラメーターの RunAs アカウントではなく PSCredential オブジェクトを指定する場合は、ドメイン アカウント名とパスワードがホスト サーバー上のプレーン テキストで簡潔に表示されるため、ドメインに仮想マシンを自動的に参加させる権限が制限されたアカウントのみを使用することをお勧めします。

例 3: 既存のゲスト オペレーティング システム プロファイルを複製する

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "NewOSProfile02"
PS C:\> $OS = Get-SCOperatingSystem -VMMServer "VMMServer01.contoso.com" | where {$_.Name -eq "64-bit edition of Windows Server 2008 R2 Datacenter"} 
PS C:\> New-SCGuestOSProfile -Name "NewOSProfile03" -GuestOSProfile $OSProfile -ComputerName "Contoso03" -OperatingSystem $OS

最初のコマンドは、NewOSProfile02 という名前のゲスト OS プロファイル オブジェクトを取得し、そのオブジェクトを $OSProfile 変数に格納します。

2 番目のコマンドは、Windows Server 2008 R2 Datacenter の 64 ビット エディションという名前のオペレーティング システム オブジェクトを取得し、$OS変数にオブジェクトを格納します。

最後のコマンドは、NewOSProfile02 に基づく NewOSProfile03 という名前のゲスト オペレーティング システム プロファイルを作成しますが、コンピューター名を変更し、オペレーティング システムの別の名前を指定します。 NewOSProfile03 の他のすべての設定は、NewOSProfile02 の設定と同じです。

例 4: Linux ゲスト オペレーティング システム プロファイルを作成し、Linux DNS ドメイン名を設定する

PS C:\> $OS = Get-SCOperatingSystem -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "CentOS Linux 6 (64 bit)"} 
PS C:\> New-SCGuestOSProfile -Name "My CentOS Profile" -LinuxDomainName "contoso.com" -OperatingSystem $os

最初のコマンドは、VMMServer01 から CentOS Linux 6 (64 ビット) という名前のオペレーティング システム オブジェクトを取得し、$OS変数にオブジェクトを格納します。

2 番目のコマンドは、My CentOS Profile という名前のゲスト オペレーティング システム プロファイルを作成し、オペレーティング システムの名前と Linux DNS ドメイン名を指定します。 My CentOS プロファイルを使用して仮想マシンを作成すると、プロファイルは指定された Linux DNS ドメイン名を使用します。

パラメーター

-AnswerFile

応答ファイルとして使用するために、VMM ライブラリに保管されているスクリプト オブジェクトを指定します。 応答ファイル スクリプトの名前は、仮想マシンにインストールするオペレーティング システムによって異なります。

• Sysprep.inf。 Windows XP、Windows Server 2000、または Windows Server 2003
• Unattend.xml。 Windows Vista、Windows 7、または Windows Server 2008

Type:	Script
Aliases:	SysPrepFile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-AutoLogonCount

応答ファイルで指定された管理者を Windows がコンソール セッションに自動的に記録する回数を指定します。

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AutoLogonCredential

管理者の自動ログオンが有効になっているときに、Windows がコンソール セッションへのログオンに使用する応答ファイルに含まれる実行アカウントを指定します。

Type:	RunAsAccount
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputerName

ネットワーク内で Virtual Machine Manager が一意に識別できるコンピュータの名前を指定します。 このパラメーターの有効値は、次のとおりです。

• FQDN
• IPv4 または IPv6 アドレス
• NetBIOS 名

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

-DeploymentTypeNano

{{Fill DeploymentTypeNano Description}}

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

ゲスト オペレーティング システム プロファイルの説明を指定します。

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

-DisableAutoLogon

このコマンドレットが管理者の自動ログオンを無効にすることを示します。

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

-Domain

Active Directory ドメインの完全修飾ドメイン名 (FQDN) を指定します。

形式の例: -Domain "Domain01.Corp.Contoso.com"

Type:	String
Aliases:	JoinDomain
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DomainJoinCredential

コンピューターをドメインに参加させるアクセス許可を持つアカウントのユーザー名とパスワードを指定します。 コンピューターをドメインに参加させる権限の制限付きアカウントを使用することをお勧めします。 これには、仮想コンピューターと物理コンピューターの両方が含まれます。

現在のパラメーターを使用すると、仮想ホスト コンピューターをドメインに参加させるための VMHostProfile の資格情報を指定したり、新しいテンプレートまたは既存のテンプレート、新規または既存のゲスト オペレーティング システム プロファイル、または新しい仮想マシン上で、仮想マシンをドメインに参加させるための資格情報を指定したりできます。

Type:	VMMCredential
Aliases:	JoinDomainCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DomainJoinOrganizationalUnit

無人ミニセットアップ中にコンピューターが参加する組織単位を指定します。

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

-FullName

バーチャル マシンの登録ユーザーの名前を指定します。

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

-GuestOSProfile

ゲスト オペレーティング システム プロファイル オブジェクトを指定します。

Type:	GuestOSProfile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-GuiRunOnceCommands

無人応答ファイルの [GuiRunOnce] セクションに追加するコマンドの配列を指定します。 二重引用符で囲まれた各文字列の周りに単一引用符を使用します。

形式の例: -GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'

Windows PowerShellで引用符を使用する方法については、「.」と入力しますGet-Help about_Quoting_Rules。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-JobVariable

ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。

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

-LinuxAdministratorSSHKey

Linux SSH キーの公開キー ファイルを指定します。

Type:	SSHKey
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LinuxAdministratorSSHKeyString

Linux 管理者 SSH キーを文字列として指定します。

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

-LinuxDomainName

Linux オペレーティング システムの特殊化と組み合わせて使用する完全修飾ドメイン名 (FQDN) を指定します。

形式の例: -LinuxDomainName "Domain01.Corp.Contoso.com"

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

-LocalAdministratorCredential

ローカル管理者アカウント (Linux 互換のゲスト オペレーティング システム プロファイルの場合は Linux ルート アカウント) のユーザー名とパスワードを指定します。

新規または既存のテンプレート、新規または既存のゲスト オペレーティング システム プロファイル、または新しい仮想マシンで資格情報を指定すると、既存の管理者パスワードがオーバーライドされます。

Type:	VMMCredential
Aliases:	AdminPasswordCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MergeAnswerFile

このコマンドレットが応答ファイルとゲスト オペレーティング システムの設定をマージするかどうかを示します。 既定値は$Trueです。 VMM コンソールでは、このパラメーターを使用します。 このパラメーターは指定しないでください。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

VMM オブジェクトの名前を指定します。

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

-OperatingSystem

バーチャル マシンのオペレーティング システムの種類を指定します。 VMM で使用可能なすべてのオペレーティング システムの名前を取得するには、「 Get-SCOperatingSystem.

Type:	OperatingSystem
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OrganizationName

仮想マシンが登録されているユーザーの組織の名前を指定します。

Type:	String
Aliases:	OrgName
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Owner

有効なドメイン ユーザー アカウントの形式で VMM オブジェクトの所有者を指定します。

• 形式の例: -Owner "Contoso\PattiFuller"
• 形式の例: -Owner "PattiFuller@Contoso"

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

-ProductKey

プロダクト キーを指定します。 プロダクト キーは製品のライセンスを識別する 25 桁の番号です。 プロダクト キーを使用して、VMM または仮想マシンまたはホストにインストールされるオペレーティング システムを登録できます。

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

-PROTipID

このアクションをトリガーしたパフォーマンスとリソース最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。

Type:	Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveDomainJoinOrganizationalUnit

このコマンドレットは、セットアップ中にコンピューターが参加した組織単位を削除することを示します。

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

-RemoveServerFeatures

このコマンドレットは、テンプレートからすべてのサーバーの役割と機能を削除することを示します。

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

-RunAsynchronously

コントロールがコマンド シェルに直ちに戻るように、ジョブが非同期的に実行されることを示します。

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

-Shielded

オブジェクトがシールドされているかどうかを示します。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TimeZone

同じ標準時間を共有する地理的リージョンを識別する数値 (インデックス) を指定します。 タイム ゾーン インデックスの一覧については、「Microsoft タイム ゾーン インデックスの値http://go.microsoft.com/fwlink/?LinkId=120935」を参照してください。 タイム ゾーンが指定されていない場合、仮想マシンに使用される既定のタイム ゾーンは、仮想マシン ホスト上にあるのと同じタイム ゾーン設定になります。

GMT 標準タイム ゾーンを指定する形式の例: -TimeZone 085

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UnattendSettings

String、String で構成されるキーと値のペアを指定します。

Type:	System.Collections.Generic.Dictionary`2[System.String,System.String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UserRole

ユーザー ロール オブジェクトを指定します。

Type:	UserRole
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VMMServer

VMM サーバー オブジェクトを指定します。

Type:	ServerConnection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Workgroup

新規または既存のテンプレート、新規または既存のゲスト オペレーティング システム プロファイル、または新しい仮想マシンで、仮想マシンに参加するワークグループの名前を指定します。 このパラメータを使用すると、テンプレートまたはゲスト オペレーティング システム プロファイルの既存の値を上書きできます。

Type:	String
Aliases:	JoinWorkgroup
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

出力

GuestOSProfile

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

関連リンク

• Get-SCGuestOSProfile
• Get-SCOperatingSystem
• Get-SCRunAsAccount
• Remove-SCGuestOSProfile
• Set-SCGuestOSProfile