Get-SCVMMServer

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 de VMM.

Syntax

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 de VMM mediante la interfaz de usuario (UI), al abrir un shell de comandos de VMM, ese shell de comandos se conecta automáticamente al mismo servidor de administración de VMM. Si no se ha conectado previamente al servidor de administración de 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 mediante el shell de comandos de 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 de 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 de VMM o en un servidor independiente que ejecuta SQL Server.

El servicio VMM permite administrar el entorno virtual, incluidos los servidores host (qué máquinas virtuales host), 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: Conectarse a un servidor VMM y obtener 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, salvo 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.

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

-ComputerName

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

  • FQDN
  • Dirección IPv4 o IPv6
  • Nombre de NetBIOS
Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 de VMM desde el shell de comandos de VMM. Los valores permitidos para este parámetro son los siguientes:

  • 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.

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

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 PSCredential , escriba Get-Help Get-Credential.

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

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-RetainDeletedObjects

Especifica que se conservarán los objetos de la memoria caché marcados 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.

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

-RetainObjectCache

Indica que los objetos de la memoria caché permanecerán en memoria y no se reclamará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.

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

-SetAsDefault

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

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

-TCPPort

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

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

-UserRoleName

Especifica el nombre de un rol de usuario. Los tipos de roles de usuario con nombre incluyen:

  • Administrador delegado
  • Administrador de solo lectura
  • Usuario de autoservicio
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False