Set-SCGuestOSProfile

モジュール:

VirtualMachineManager

VMM で使用されるゲスト オペレーティング システム プロファイルのプロパティを変更します。

構文

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

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

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

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

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

説明

Set-SCGuestOSProfile コマンドレットは、仮想マシン マネージャー (VMM) 環境で使用されるゲスト オペレーティング システム プロファイルの 1 つ以上のプロパティを変更します。 ゲスト オペレーティング システム プロファイルに加えられた変更は、ゲスト オペレーティング システム プロファイル自体にのみ影響します。 変更は、このプロファイルを使用して以前に作成された既存の仮想マシンには影響しません。

例

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

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "NewOSProfile01"
PS C:\> Set-SCGuestOSProfile -GuestOSProfile $OSProfile -OrgName "Contoso"

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

2 番目のコマンドでは、Contoso を、$OSProfileに格納されているゲスト オペレーティング システム プロファイルの組織名として設定します。

例 2: 既存の Linux ゲスト オペレーティング システム プロファイルの SSHKey を指定する

注意

この記事では、終了 (EOL) 状態に達した Linux ディストリビューションである CentOS を参照します。 それに応じて、使用と計画を検討してください。 詳細については、CentOS End Of Life ガイダンスを参照してください。

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "My CentOS Profile"
PS C:\> $Sshkey = Get-SCSSHKey -Name "My.Sshkey"
PS C:\> Set-SCGuestOSProfile -GuestOSProfile $OSProfile -LinuxAdministratorSSHKey $Sshkey

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

2 番目のコマンドは、My.Sshkey という名前の SSHKey オブジェクトを取得し、$Sshkey変数にオブジェクトを格納します。

最後のコマンドは、$OSProfileに格納されているゲスト オペレーティング システム プロファイルに My.sshkey オブジェクトを設定します。

パラメーター

-AnswerFile

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

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

型:	Script
Aliases:	SysPrepFile
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-AutoLogonCount

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

型:	UInt32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AutoLogonCredential

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

型:	RunAsAccount
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ComputerName

VMM がネットワーク上で一意に識別できるコンピューターの名前を指定します。 このパラメーターに使用できる値は次のとおりです。

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DeploymentTypeNano

{{Fill DeploymentTypeNano Description}}

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Description

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisableAutoLogon

管理者の自動ログオンを無効にします。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Domain

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

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

型:	String
Aliases:	JoinDomain
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DomainJoinCredential

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

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

型:	VMMCredential
Aliases:	JoinDomainCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DomainJoinOrganizationalUnit

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-FullName

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-GuestOSProfile

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

型:	GuestOSProfile
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-GuiRunOnceCommands

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

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

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

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-JobVariable

ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-LinuxAdministratorSSHKey

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

型:	SSHKey
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-LinuxAdministratorSSHKeyString

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-LinuxDomainName

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

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-LocalAdministratorCredential

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

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

型:	VMMCredential
Aliases:	AdminPasswordCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-MergeAnswerFile

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

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Name

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-OperatingSystem

仮想マシンのオペレーティング システムの種類を指定します。

VMM で使用可能なすべてのオペレーティング システムの名前を取得するには、「Get-SCOperatingSystem」と入力します。

型:	OperatingSystem
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-OrganizationName

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

型:	String
Aliases:	OrgName
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Owner

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

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ProductKey

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PROTipID

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

型:	Guid
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveDomainJoinOrganizationalUnit

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoveServerFeatures

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RunAsynchronously

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Shielded

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

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-TimeZone

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

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

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UnattendSettings

文字列文字列で構成されるキーと値のペア 指定します。

型:	System.Collections.Generic.Dictionary`2[System.String,System.String]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UserRole

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

型:	UserRole
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Workgroup

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

型:	String
Aliases:	JoinWorkgroup
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

出力

GuestOSProfile

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

メモ

• Get-SCGuestOSProfile コマンドレットを使用して取得できる VMM ゲスト OS プロファイル オブジェクトが必要です。

関連リンク

• Get-SCGuestOSProfile
• New-SCGuestOSProfile
• Remove-SCGuestOSProfile