New-SCPhysicalComputerConfig
コンピューター構成オブジェクトを作成します。
構文
New-SCPhysicalComputerConfig
-PhysicalComputerProfile <PhysicalComputerProfile>
[-BMCAddress <String>]
[-BMCRunAsAccount <RunAsAccount>]
[-BMCPort <Int32>]
[-BMCProtocol <OutOfBandManagementType>]
[-BMCCustomConfigurationProvider <ConfigurationProvider>]
[-PhysicalComputerNetworkAdapterConfig <PhysicalComputerNetworkAdapterConfig[]>]
[-VMMServer <ServerConnection>]
[-Description <String>]
[-ComputerName <String>]
[-BootDiskVolume <String>]
-Computer <ClientObject>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] New-SCPhysicalComputerConfig
-PhysicalComputerProfile <PhysicalComputerProfile>
[-SMBiosGuid <Guid>]
[-SkipBmcPowerControl]
-PhysicalComputerNetworkAdapterConfig <PhysicalComputerNetworkAdapterConfig[]>
[-VMMServer <ServerConnection>]
[-Description <String>]
-ComputerName <String>
[-VMHostGroup <HostGroup>]
[-BypassADMachineAccountCheck]
[-BootDiskVolume <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] New-SCPhysicalComputerConfig
-PhysicalComputerProfile <PhysicalComputerProfile>
[-SMBiosGuid <Guid>]
-BMCAddress <String>
-BMCRunAsAccount <RunAsAccount>
[-BMCPort <Int32>]
-BMCProtocol <OutOfBandManagementType>
[-BMCCustomConfigurationProvider <ConfigurationProvider>]
-PhysicalComputerNetworkAdapterConfig <PhysicalComputerNetworkAdapterConfig[]>
[-VMMServer <ServerConnection>]
[-Description <String>]
-ComputerName <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 モジュールを作成することもできます。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BMCCustomConfigurationProvider
ベースボード管理コントローラー (BMC) の構成プロバイダー オブジェクトを指定または更新します。 構成プロバイダーは、VMM PowerShell コマンドをベースボード管理コントローラーの種類に固有の API 呼び出しに変換する VMM へのプラグインです。 このパラメーターは、カスタム BMCProtocol と共に使用する必要があります。
| Type: | ConfigurationProvider |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BMCPort
特定の物理マシンの帯域外ベースボード管理コントローラー (BMC) ポートを指定または更新します。 BMC ポートは、サービス プロセッサ ポートとも呼ばれます。 既定のポートの例は、IPMI の場合は 623、WS-Man 経由のスマッシュの場合は 443 です。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BMCProtocol
VMM が帯域外ベースボード管理コントローラー (BMC) との通信に使用するプロトコルを指定または更新します。 有効な値は次のとおりです。
- IPMI
- スマッシュ
- Custom
BMC (サービス プロセッサまたは管理コントローラーとも呼ばれます) は、ハードウェアとシステム管理ソフトウェアの間のインターフェイスを機能するサーバーのマザーボード上の特殊なコントローラーです。 物理マシンのマザーボードに BMC が含まれている場合、マシンが接続されている場合 (電源が切れているか電源がオンになっているか、オペレーティング システムがインストールされているかどうか)、システム ハードウェアとそのシステム ハードウェアの正常性の状態に関する情報を利用できます。
形式の例: -BMCProtocol "Custom"
注: カスタム・プロトコルでは、 BMCCustomConfigurationProvider パラメーターを使用する必要があります。
| Type: | OutOfBandManagementType |
| Accepted values: | None, IPMI, SMASH, Custom, None, IPMI, SMASH, Custom |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BMCRunAsAccount
ベースボード管理コントローラー (BMC) デバイスで使用する実行アカウントを指定します。
| Type: | RunAsAccount |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BootDiskVolume
物理マシンの物理ハード ディスク オブジェクトを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BypassADMachineAccountCheck
このコマンドレットは、Active Directory に既に存在するコンピューター アカウントを再利用することを示します。 既定では、このコマンドレットは、コンピューター アカウントの上書きを防ぐために、指定した名前の既存のアカウントの Active Directory をチェックします。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 モジュールを作成することもできます。
| Type: | ClientObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ComputerName
ネットワーク内で Virtual Machine Manager が一意に識別できるコンピュータの名前を指定します。 このパラメーターの有効値は、次のとおりです。
- FQDN
- IPv4 または IPv6 アドレス
- NetBIOS 名
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |
-JobVariable
ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PhysicalComputerNetworkAdapterConfig
PhysicalComputerNetworkAdapterConfig オブジェクトの配列を指定します。
| Type: | PhysicalComputerNetworkAdapterConfig[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PhysicalComputerProfile
オペレーティング システムをコンピューターに展開するために使用するプロファイルを指定します。
| Type: | PhysicalComputerProfile |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |
-RunAsynchronously
コントロールがコマンド シェルに直ちに戻るように、ジョブが非同期的に実行されることを示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SkipBmcPowerControl
BMC 情報をスキップし、BMC インターフェイスを使用してコンピューターの電源をオンまたはオフにせずにオペレーティング システムを展開します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SMBiosGuid
VMM でその物理コンピューターのレコードに関連付けられている物理コンピューターの System Management BIOS グローバル一意識別子 (SMBIOS GUID) を指定します。 SMBIOS は、ユーザーまたはアプリケーションが、システム、製造元、システム BIOS バージョンの名前など、このコンピューター上のハードウェアに関する情報を格納および取得できるようにするデータ構造とアクセス方法を定義します。 Windows オペレーティング システムは、システムの起動時に SMBIOS データを取得し、そのデータをプログラムで使用できるようにします。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHostGroup
仮想マシン ホスト グループ オブジェクトまたはホスト グループ オブジェクトの配列を指定します。
| Type: | HostGroup |
| 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 |
出力
PhysicalComputerConfig
このコマンドレットは 、PhysicalComputerConfig オブジェクトを返します。