New-SCPhysicalComputerConfig
構文
FromExistingComputer
New-SCPhysicalComputerConfig
-PhysicalComputerProfile <PhysicalComputerProfile>
-Computer <ClientObject>
[-BMCAddress <String>]
[-BMCRunAsAccount <RunAsAccount>]
[-BMCPort <Int32>]
[-BMCProtocol <OutOfBandManagementType>]
[-BMCCustomConfigurationProvider <ConfigurationProvider>]
[-PhysicalComputerNetworkAdapterConfig <PhysicalComputerNetworkAdapterConfig[]>]
[-VMMServer <ServerConnection>]
[-Description <String>]
[-ComputerName <String>]
[-BootDiskVolume <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
SkipBMCPowerControl
New-SCPhysicalComputerConfig
-PhysicalComputerProfile <PhysicalComputerProfile>
-PhysicalComputerNetworkAdapterConfig <PhysicalComputerNetworkAdapterConfig[]>
-ComputerName <String>
[-SMBiosGuid <Guid>]
[-SkipBmcPowerControl]
[-VMMServer <ServerConnection>]
[-Description <String>]
[-VMHostGroup <HostGroup>]
[-BypassADMachineAccountCheck]
[-BootDiskVolume <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
UseBMCPowerControl
New-SCPhysicalComputerConfig
-PhysicalComputerProfile <PhysicalComputerProfile>
-BMCAddress <String>
-BMCRunAsAccount <RunAsAccount>
-BMCProtocol <OutOfBandManagementType>
-PhysicalComputerNetworkAdapterConfig <PhysicalComputerNetworkAdapterConfig[]>
-ComputerName <String>
[-SMBiosGuid <Guid>]
[-BMCPort <Int32>]
[-BMCCustomConfigurationProvider <ConfigurationProvider>]
[-VMMServer <ServerConnection>]
[-Description <String>]
[-VMHostGroup <HostGroup>]
[-BypassADMachineAccountCheck]
[-BootDiskVolume <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
説明
New-SCPhysicalComputerConfig コマンドレットは、オペレーティング システムのカスタマイズ プロセス中に使用されるコンピューター構成オブジェクトを作成します。
例
例 1: 物理コンピューター構成を作成する
PS C:\> $Account = Get-SCRunaAsAccount -Name "BMCAdmin"
PS C:\> $PhysicalComputerProfile = Get-SCPhysicalComputerProfile -ID "d1ce0773-4f50-4f12-a244-38a5a35c5326"
PS C:\> $NetworkAdapters = New-SCPhysicalComputerNetworkAdapterConfig -UseDhcpForIPConfiguration -SetAsManagementNIC -SetAsPhysicalNetworkAdapter
PS C:\> $HostGroup = Get-SCVMHostGroup -ID "0e3ba228-a059-46be-aa41-2f5cf0f4b96e"
PS C:\> New-SCPhysicalComputerConfig -BMCAddress 10.0.0.21 -BMCPort 623 -BMCProtocol IPMI -BMCRunAsAccount $Account -ComputerName "Host01" -SMBiosGuid "4c4c4544-0039-4410-8042-c3c04f395031" -PhysicalComputerProfile $PhysicalComputerProfile -VMHostGroup $HostGroup -PhysicalComputerNetworkAdapterConfig $NetworkAdapters
最初のコマンドは、実行アカウント オブジェクトを取得し、それを $Account 変数に格納します。
2 番目のコマンドは、ID が d1ce0773-4f50-4f12-a244-38a5a35c5326 の物理コンピューター プロファイルを $PhysicalComputerProfile 変数に格納します。
3 番目のコマンドは、物理コンピューター ネットワーク アダプター構成を作成し、$NetworkAdapters 変数に格納します。
4 番目のコマンドレットは、ホスト グループを $HostGroup 変数に格納します。
最後のコマンドは、物理コンピューター構成を作成します。
このコマンドは、前のコマンドで作成した値を指定します。
パラメーター
-BMCAddress
特定の物理マシンのアウトオブバンド ベースボード管理コントローラー (BMC) アドレスを指定または更新します。
これには、IP アドレス、完全修飾ドメイン名 (FQDN)、または DNS プレフィックス (通常は NetBIOS 名と同じ名前) があります。
通常、BMC アドレスとそのネットワークへの接続は、標準のネットワーク アダプターに関連付けられている IP アドレスとは別のものです。
また、一部のコンピュータでは、標準のネットワーク アダプタを使用して、BMC とネットワーク アダプタに 1 つのアドレスを提供します。
ただし、BMC アドレスには一意のポートがあるため、ネットワーク上で一意に識別できます。
- IPv4 形式の例:
-BMCAddress "10.0.0.21"
- IPv6形式の例:
-BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829"
- FQDN 形式の例:
-BMCAddress "Computer01.Contoso.com"
- NetBIOS 形式の例:
-BMCAddress "Computer01"
注: 既定では、VMM は BMC アドレスに IP アドレスまたは FQDN を使用します。
ただし、他の種類のアドレスを BMC アドレスとして指定できる PowerShell モジュールを作成することもできます。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
FromExistingComputer
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-BMCCustomConfigurationProvider
ベースボード管理コントローラー (BMC) の構成プロバイダー オブジェクトを指定または更新します。
構成プロバイダーは、VMM PowerShell コマンドをベースボード管理コントローラーの種類に固有の API 呼び出しに変換する VMM のプラグインです。
このパラメータは、カスタム BMCProtocol と共に使用する必要があります。
パラメーターのプロパティ
| 型: | ConfigurationProvider
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
FromExistingComputer
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
UseBMCPowerControl
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-BMCPort
特定の物理マシンのアウトオブバンド ベースボード管理コントローラー (BMC) ポートを指定または更新します。
BMC ポートは、サービス・プロセッサー・ポートとも呼ばれます。
デフォルトのポートの例としては、IPMI の場合は 623、WS-MAN 経由の SMASH の場合は 443 があります。
パラメーターのプロパティ
| 型: | Int32
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
FromExistingComputer
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
UseBMCPowerControl
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-BMCProtocol
VMM が帯域外ベースボード管理コントローラー (BMC) との通信に使用するプロトコルを指定 (更新) します。
有効な値は次のとおりです。
BMC (サービス プロセッサまたは管理コントローラーとも呼ばれます) は、サーバーのマザーボード上にある特殊なコントローラーで、ハードウェアとシステム管理ソフトウェアの間のインターフェイスとして機能します。
物理マシンのマザーボードに BMC が含まれている場合、マシンが接続されると (電源がオフになっているか電源がオンになっているか、オペレーティング システムがインストールされているかどうか)、システム ハードウェアに関する情報とそのシステム ハードウェアの正常性の状態が使用可能になります。
形式の例: -BMCProtocol "Custom"
注: カスタム・プロトコルでは、 BMCCustomConfigurationProvider パラメーターを使用する必要があります。
パラメーターのプロパティ
| 型: | OutOfBandManagementType
|
| 規定値: | None |
| 指定可能な値: | None, IPMI, SMASH, Custom |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
FromExistingComputer
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-BMCRunAsAccount
ベースボード管理コントローラー (BMC) デバイスで使用する実行アカウントを指定します。
パラメーターのプロパティ
| 型: | RunAsAccount
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
FromExistingComputer
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-BootDiskVolume
物理マシンの物理ハード ディスク オブジェクトを指定します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-BypassADMachineAccountCheck
このコマンドレットが Active Directory に既に存在するコンピューター アカウントを再利用することを示します。
既定では、このコマンドレットは、コンピューター アカウントの上書きを防ぐために、指定した名前の既存のアカウントを Active Directory でチェックします。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
SkipBMCPowerControl
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
UseBMCPowerControl
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Computer
特定の物理マシンのアウトオブバンド ベースボード管理コントローラー (BMC) アドレスを指定または更新します。
これには、IP アドレス、完全修飾ドメイン名 (FQDN)、または DNS プレフィックス (通常は NetBIOS 名と同じ名前) があります。
- IPv4 形式の例:
-BMCAddress "10.0.0.21"
- IPv6形式の例:
-BMCAddress "2001:4898:2a:3:657b:9c7a:e1f0:6829"
- FQDN 形式の例:
-BMCAddress "Computer01.Contoso.com"
- NetBIOS 形式の例:
-BMCAddress "Computer01"
注: 既定では、VMM は BMC アドレスに IP アドレスまたは FQDN を使用します。
ただし、他の種類のアドレスを BMC アドレスとして指定できる PowerShell モジュールを作成することもできます。
パラメーターのプロパティ
| 型: | ClientObject
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
FromExistingComputer
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ComputerName
VMM がネットワーク上で一意に識別できるコンピューターの名前を指定します。
このパラメーターに使用できる値は次のとおりです。
- FQDN
- IPv4 または IPv6 アドレス
- NetBIOS 名
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
FromExistingComputer
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Description
構成オブジェクトの説明を指定します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-JobVariable
ジョブの進行状況を追跡され、このパラメーターで指定された変数に格納するように指定します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PhysicalComputerNetworkAdapterConfig
PhysicalComputerNetworkAdapterConfig オブジェクトの配列を指定します。
パラメーターのプロパティ
| 型: | PhysicalComputerNetworkAdapterConfig[]
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
FromExistingComputer
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PhysicalComputerProfile
オペレーティング システムをコンピューターに展開するために使用されるプロファイルを指定します。
パラメーターのプロパティ
| 型: | PhysicalComputerProfile
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。
このパラメーターを使用すると、PRO のヒントを監査できます。
パラメーターのプロパティ
| 型: | Guid
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SkipBmcPowerControl
BMC 情報をスキップし、BMC インターフェイスを使用してコンピューターの電源をオンまたはオフにせずにオペレーティング システムを展開します。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
SkipBMCPowerControl
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SMBiosGuid
VMM の物理コンピューターのレコードに関連付けられている物理コンピューターのシステム管理 BIOS グローバル一意識別子 (SMBIOS GUID) を指定します。
SMBIOS は、ユーザーまたはアプリケーションがシステムの名前、製造元、システム BIOS バージョンなど、このコンピューター上のハードウェアに関する情報を格納および取得できるようにするデータ構造とアクセス方法を定義します。
Windows オペレーティング システムは、システムの起動時に SMBIOS データを取得し、そのデータをプログラムで使用できるようにします。
パラメーターのプロパティ
| 型: | Guid
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
SkipBMCPowerControl
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
UseBMCPowerControl
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-VMHostGroup
仮想マシンのホストグループオブジェクトまたはホストグループオブジェクトの配列を指定します。
パラメーターのプロパティ
| 型: | HostGroup
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
SkipBMCPowerControl
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
UseBMCPowerControl
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
パラメーターのプロパティ
| 型: | ServerConnection
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力
PhysicalComputerConfig
このコマンドレットは、 PhysicalComputerConfig オブジェクトを返します。