Compartir a través de

Get-SCVMMServer

  • Referencia
Módulo:
VirtualMachineManager

Se conecta a un servidor de administración VMM si aún no existe una conexión o se conecta a otro servidor de administración VMM.

Sintaxis

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

Description

El cmdlet Get-SCVMMServer se conecta a un servidor de administración de Virtual Machine Manager (VMM) si aún no existe una conexión y recupera el objeto de servidor de la base de datos VMM. El puerto predeterminado que se usa para conectarse a un servidor VMM es el puerto TCP 8100.

Si ha creado una conexión a un servidor de administración VMM mediante la interfaz de usuario (UI), al abrir un shell de comandos VMM, ese shell de comandos se conecta automáticamente al mismo servidor de administración VMM. Si no se ha conectado previamente al servidor de administración VMM mediante la interfaz de usuario, debe usar Get-SCVMMServer para establecer una conexión. Tenga en cuenta que si se conecta a un servidor de administración VMM solo con el shell de comandos VMM, debe usar el parámetro SetAsDefault para conservar la conexión de la sesión a la sesión o volver a conectarse al servidor VMM cada vez que abra una nueva sesión de shell de comandos de VMM.

También puede usar get-VMMServer para conectarse a otro servidor de administración VMM.

Una vez establecida una conexión al servidor de administración VMM, todos los comandos futuros se ejecutan en la línea de comandos del shell de comandos VMM que requiere que el objeto de servidor VMM use automáticamente la conexión existente hasta que cierre esa ventana del shell de comandos de VMM.

El servicio VMM que se ejecuta en el servidor de administración VMM admite la base de datos VMM. Esta base de datos se almacena en Microsoft SQL Server en el propio servidor de administración VMM o en un servidor independiente que ejecuta SQL Server.

El servicio VMM permite administrar el entorno virtual, incluidos los servidores host (que hospedan máquinas virtuales), los servidores de biblioteca (que almacenan recursos de biblioteca VMM) y las máquinas virtuales implementadas en un host o almacenadas en la biblioteca.

Para obtener más información sobre cómo conectarse al servidor de administración VMM, escriba Get-Help about_VMM_2016_Connecting_to_the_VMM_Server.

Ejemplos

Ejemplo 1: Conexión a un servidor VMM

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

Este comando se conecta al servidor VMM denominado VMMServer01 ubicado en el dominio contoso y obtiene el objeto de servidor de la base de datos VMM.

Ejemplo 2: Conexión a un servidor VMM a través de un puerto específico

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

Este comando se conecta a través del puerto TCP 8100 al servidor VMM denominado VMMServer01 ubicado en el dominio contoso.

Ejemplo 3: Conexión a un servidor VMM y obtención de su tipo de objeto, métodos y propiedades de .NET

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

El primer comando obtiene el objeto de servidor VMM denominado VMMServer01 y almacena el objeto en la variable $VMMServer.

El segundo comando pasa el objeto de servidor VMM almacenado en $VMMServer al cmdlet Get-Member, que recupera y muestra lo siguiente:

  • TypeName: el nombre de tipo de .NET del objeto de servidor VMM: Microsoft.SystemCenter.VirtualMachineManager.Remoting.ServerConnection

  • MemberType: lista que contiene el nombre y la definición de cada evento, método y propiedad asociados a este tipo de objeto.

El tercer comando recupera y muestra la misma información que el segundo comando, excepto que canaliza la salida al cmdlet Format-List para mostrar la definición completa de cada método y cada propiedad para el objeto de servidor VMM.

Ejemplo 4: Conexión a un servidor VMM diferente con un rol de usuario diferente

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

Este comando se conecta al servidor VMM denominado VMMServer02 ubicado en el dominio contoso mediante el rol de usuario DelegatedAdmin.

Parámetros

-AllowJobGC

Indica que se permite la recolección de elementos no utilizados para los trabajos.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ComputerName

Especifica el nombre de un equipo que VMM puede identificar de forma única en la red. Los valores aceptables para este parámetro son:

  • FQDN
  • Dirección IPv4 o IPv6
  • Nombre netBIOS
Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ConnectAs

Especifica el rol de usuario VMM que se va a usar, si el usuario es miembro de más de un rol, al conectarse al servidor de administración VMM desde el shell de comandos de VMM. Los valores aceptables para este parámetro son:

  • Administrador
  • DelegatedAdmin
  • ReadOnlyAdmin
  • SelfServiceUser

Los administradores de VMM pueden administrar todos los objetos VMM. Los administradores delegados y los usuarios de autoservicio pueden acceder y cambiar solo los objetos que están dentro del ámbito de sus roles de usuario. Read-Only administradores solo pueden ver las propiedades de los objetos existentes; no pueden crear nuevos objetos ni cambiar las propiedades de los objetos existentes.

Tipo:Profile
Valores aceptados:Administrator, DelegatedAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Credential

Especifica un objeto de credencial o, para algunos cmdlets, un objeto de cuenta de ejecución que contiene el nombre de usuario y la contraseña de una cuenta que tiene permiso para realizar esta acción. O bien, en el caso de Restart-SCJob, tiene permiso para completar una tarea reiniciada.

Para obtener más información sobre el objeto de PSCredential, escriba Get-Help Get-Credential.

Para obtener más información sobre las cuentas de ejecución, escriba Get-Help New-SCRunAsAccount.

Tipo:PSCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForOnBehalfOf

Indica que un administrador puede usar parámetros onBehalfOf, cuando está disponible, para los cmdlets de VMM. Este parámetro se usa principalmente para las conexiones de Service Provider Foundation a VMM.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RetainDeletedObjects

Especifica que se conservarán los objetos de la memoria caché marcadas para su eliminación. Es posible que solo necesite este parámetro si crea una interfaz de usuario sobre el shell de comandos de VMM.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RetainObjectCache

Indica que los objetos de la memoria caché permanecerán en memoria y no se recuperarán mediante la recolección de elementos no utilizados. Es posible que necesite este parámetro si crea una interfaz de usuario sobre el shell de comandos de VMM.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SetAsDefault

Indica, cuando se establece en $True, que el shell de comandos de VMM se conecta al servidor de administración VMM especificado para esta sesión y conserva esa conexión para futuras sesiones.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-TCPPort

Especifica un valor numérico que representa un puerto TCP.

Tipo:Int32
Alias:Port
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UserRoleName

Especifica el nombre de un rol de usuario. Los tipos de roles de usuario denominados son:

  • Administrador delegado
  • administrador de Read-Only
  • usuario de Self-Service
Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False