Read-SCVMHost
Read-SCVMHost
Refreshes virtual machine host properties in the VMM console.
構文
Parameter Set: DefaultRefresh
Read-SCVMHost [-VMHost] <Host> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [ <CommonParameters>]
Parameter Set: OutOfBandRefresh
Read-SCVMHost [-VMHost] <Host> [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RefreshOutOfBandProperties] [-RunAsynchronously] [ <CommonParameters>]
詳細説明
The Read-SCVMHost cmdlet refreshes the properties of a virtual machine host so that the Virtual Machine Manager (VMM) console displays updated information about the host.
Host properties that this cmdlet updates include:
-- Name
-- Operating system
-- Status, such as Responding
-- Host volumes, typically, addition or removal of drive letters, mount points, as well as used and available space
-- Network adapters, addition or removal
パラメーター
-JobVariable<String>
Specifies that job progress is tracked and stored in the variable named by this parameter.
エイリアス |
none |
必須? |
false |
位置は? |
named |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-PROTipID<Guid]>
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.
エイリアス |
none |
必須? |
false |
位置は? |
named |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-RefreshOutOfBandProperties
Refreshes available computer hardware properties through the out-of-band baseboard management controller (BMC). This process is different from the regular host refreshing logic, because the host refresher goes through the VMM agent inside the operating system (in-band). The properties that are refreshed through BMC are different from those in the in-band refresher.
エイリアス |
none |
必須? |
false |
位置は? |
named |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-RunAsynchronously
Indicates that the job runs asynchronously so that control returns to the command shell immediately.
エイリアス |
none |
必須? |
false |
位置は? |
named |
既定値 |
none |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-VMHost<Host>
Specifies a virtual machine host object. VMM supports Hyper-V hosts, VMware ESX hosts, and Citrix XenServer hosts.
For more information about each type of host, type Get-Help Add-SCVMHost -detailed. See the examples for a specific cmdlet to determine how that cmdlet uses this parameter.
エイリアス |
none |
必須? |
true |
位置は? |
1 |
既定値 |
none |
パイプライン入力を許可する |
True (ByValue) |
ワイルドカード文字を許可する |
false |
<CommonParameters>
このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。
入力
入力型は、コマンドレットにパイプできるオブジェクトの型です。
出力
出力型は、コマンドレットによって生成されるオブジェクトの型です。
- Host
例
Example 1: Refresh information about a specific host
The first command gets the host object named VMHost01, and then stores the object in the $VMHost variable.
The second command refreshes the properties for VMHost01 so that current information about this host will appear in the VMM console.
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01"
PS C:\> Read-SCVMHost -VMHost $VMHost
Example 2: Refresh information about all hosts
This command refreshes information about all hosts managed by VMMServer01 so that current information about each host will appear in the VMM Console.
PS C:\> Get-SCVMHost -VMMServer "VMMServer01.Contoso.com" | Read-SCVMHost
Example 3: Refresh information about a given host through its OOB channel
This command refreshes information about host VMHost02 using its out-of-band interface so that current information about the host appears in the VMM console.
PS C:\> Get-SCVMHost -ComputerName "VMHost02" | Read-SCVMHost -RefreshOutOfBandProperties