Get-SCVMMServer

  • 参考
模块:
VirtualMachineManager

如果连接尚不存在，或连接到其他 VMM 管理服务器，则连接到 VMM 管理服务器。

语法

Get-SCVMMServer
   [-ComputerName] <String>
   [-TCPPort <Int32>]
   [-ConnectAs <Profile>]
   [-UserRoleName <String>]
   [-Credential <PSCredential>]
   [-RetainObjectCache]
   [-RetainDeletedObjects]
   [-AllowJobGC]
   [-SetAsDefault]
   [-ForOnBehalfOf]
   [<CommonParameters>]

说明

Get-SCVMMServer cmdlet 连接到 Virtual Machine Manager (VMM) 管理服务器（如果连接尚不存在），并从 VMM 数据库检索服务器对象。 用于连接到 VMM 服务器的默认端口是 TCP 端口 8100。

如果已使用用户界面 (UI) 创建与 VMM 管理服务器的连接，则打开 VMM 命令 shell 时，该命令 shell 会自动连接到同一 VMM 管理服务器。 如果以前未使用 UI 连接到 VMM 管理服务器，则需要使用 Get-SCVMMServer 建立连接。 请注意，如果仅使用 VMM 命令行界面连接到 VMM 管理服务器，则必须使用 SetAsDefault 参数保留从会话到会话的连接，或者在每次打开新的 VMM 命令行界面会话时重新连接到 VMM 服务器。

还可以使用 Get-VMMServer 连接到其他 VMM 管理服务器。

建立与 VMM 管理服务器的连接后，所有将来的命令在需要 VMM 服务器对象的 VMM 命令行上运行，这些命令将自动使用现有连接，直到关闭该 VMM 命令行界面窗口。

VMM 管理服务器上运行的 VMM 服务支持 VMM 数据库。 此数据库存储在 Microsoft SQL Server VMM 管理服务器本身或运行SQL Server的单独服务器上。

VMM 服务使你能够管理虚拟环境，包括主机服务器 (托管虚拟机) 、库服务器 (存储 VMM 库资源) ，以及部署在主机上或存储在库中的虚拟机。

有关连接到 VMM 管理服务器的详细信息，请键入 Get-Help about_VMM_2016_Connecting_to_the_VMM_Server。

示例

示例 1：连接到 VMM 服务器

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"

此命令连接到位于 Contoso 域中的名为 VMMServer01 的 VMM 服务器，并从 VMM 数据库中获取服务器对象。

示例 2：通过特定端口连接到 VMM 服务器

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com" -TCPPort 8100

此命令通过 TCP 端口 8100 连接到位于 Contoso 域中的名为 VMMServer01 的 VMM 服务器。

示例 3：连接到 VMM 服务器并获取其 .NET 对象类型、方法和属性

PS C:\> $VMMServer = Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> $VMMServer | Get-Member
PS C:\> $VMMServer | Get-Member | Format-List

第一个命令获取名为 VMMServer01 的 VMM 服务器对象，并将对象存储在$VMMServer变量中。

第二个命令将存储在$VMMServer中的 VMM 服务器对象传递给 Get-Member cmdlet，该 cmdlet 检索并显示以下内容：

  • TypeName：VMM 服务器对象的 .NET 类型名称： Microsoft.SystemCenter.VirtualMachineManager.Remoting.ServerConnection

  • MemberType：包含与此对象类型关联的每个事件、方法和属性的名称和定义的列表。

第三个命令检索并显示与第二个命令相同的信息，只不过它通过管道将输出传递给 Format-List cmdlet 以显示 VMM 服务器对象的每个方法和每个属性的完整定义。

示例 4：连接到具有不同用户角色的不同 VMM 服务器

PS C:\> Get-SCVMMServer -ComputerName "VMMServer02.Contoso.com" -ConnectAs "DelegatedAdmin"

此命令使用 DelegatedAdmin 用户角色连接到 Contoso 域中名为 VMMServer02 的 VMM 服务器。

参数

-AllowJobGC

指示作业允许垃圾回收。

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

-ComputerName

指定 VMM 可以在您的网络上唯一标识的计算机的名称。 此参数的可接受值为：

  • FQDN
  • IPv4 或 IPv6 地址
  • NetBIOS 名称
Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ConnectAs

指定在从 VMM 命令行界面连接到 VMM 管理服务器时，如果用户是多个角色的成员，则指定要使用的 VMM 用户角色。 此参数的可接受值为：

  • 管理员
  • DelegatedAdmin
  • ReadOnlyAdmin
  • SelfServiceUser

VMM 管理员可以管理所有 VMM 对象。 委派的管理员和自助服务用户可以访问和更改其用户角色范围内的对象。 Read-Only管理员只能查看现有对象的属性;它们无法创建新对象或更改现有对象的属性。

Type:Profile
Accepted values:Administrator, DelegatedAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

指定凭据对象，或者，对于某些 cmdlet，一个运行方式帐户对象，该对象包含有权执行此操作的帐户的用户名和密码。 或者，对于 Restart-SCJob，有权完成重启的任务。

有关 PSCredential 对象的详细信息，请键入 Get-Help Get-Credential。

有关运行方式帐户的详细信息，请键入 Get-Help New-SCRunAsAccount。

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

-ForOnBehalfOf

指示管理员能够对 VMM cmdlet 使用 OnBehalfOf 参数（如果可用）。 此参数主要用于与 VMM 的 Service Provider Foundation 连接。

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

-RetainDeletedObjects

指定将保留标记为要删除的缓存中的对象。 仅当在 VMM 命令行界面顶部创建用户界面时，才可能需要此参数。

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

-RetainObjectCache

指示缓存中的对象将保留在内存中，不会由垃圾回收回收回收。 如果在 VMM 命令行界面顶部创建用户界面，可能需要此参数。

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

-SetAsDefault

指示当设置为$True时，VMM 命令行界面将连接到此会话的指定 VMM 管理服务器，并为将来的会话保留该连接。

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

-TCPPort

指定代表 TCP 端口的数值。

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

-UserRoleName

指定用户角色的名称。 命名的用户角色的类型包括：

  • 委派的管理员
  • 只读管理员
  • 自助服务用户
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False