Get-SCVMMServer

  • Référence
Module:
VirtualMachineManager

Se connecte à un serveur d’administration VMM si une connexion n’existe pas déjà ou se connecte à un autre serveur d’administration VMM.

Syntax

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

Description

L’applet de commande Get-SCVMMServer se connecte à un serveur d’administration Virtual Machine Manager (VMM) si une connexion n’existe pas déjà et récupère l’objet serveur à partir de la base de données VMM. Le port par défaut utilisé pour se connecter à un serveur VMM est le port TCP 8100.

Si vous avez créé une connexion à un serveur d’administration VMM à l’aide de l’interface utilisateur(IU), lorsque vous ouvrez un interpréteur de commandes VMM, cet interpréteur de commandes se connecte automatiquement au même serveur d’administration VMM. Si vous n’avez pas encore connecté au serveur d’administration VMM à l’aide de l’interface utilisateur, vous devez utiliser Get-SCVMMServer pour établir une connexion. Notez que si vous vous connectez à un serveur d’administration VMM uniquement à l’aide de l’interpréteur de commandes VMM, vous devez utiliser le paramètre SetAsDefault pour conserver la connexion de la session à la session, ou vous reconnecter au serveur VMM chaque fois que vous ouvrez une nouvelle session d’interpréteur de commandes VMM.

Vous pouvez également utiliser Get-VMMServer pour vous connecter à un autre serveur d’administration VMM.

Une fois qu’une connexion au serveur d’administration VMM est établie, toutes les commandes futures s’exécutent sur la ligne de commande de l’interpréteur de commandes VMM qui nécessite l’objet serveur VMM utilise automatiquement la connexion existante jusqu’à ce que vous fermiez cette fenêtre de l’interpréteur de commandes VMM.

Le service VMM s’exécutant sur le serveur d’administration VMM prend en charge la base de données VMM. Cette base de données est stockée dans Microsoft SQL Server sur le serveur d’administration VMM lui-même ou sur un serveur distinct exécutant SQL Server.

Le service VMM vous permet de gérer votre environnement virtuel, y compris les serveurs hôtes (machines virtuelles hôtes), les serveurs de bibliothèque (qui stockent les ressources de bibliothèque VMM) et les machines virtuelles déployées sur un hôte ou stockées dans la bibliothèque.

Pour plus d’informations sur la connexion au serveur d’administration VMM, tapez Get-Help about_VMM_2016_Connecting_to_the_VMM_Server.

Exemples

Exemple 1 : Se connecter à un serveur VMM

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

Cette commande se connecte au serveur VMM nommé VMMServer01 situé dans le domaine Contoso et obtient l’objet serveur à partir de la base de données VMM.

Exemple 2 : Se connecter à un serveur VMM via un port spécifique

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

Cette commande se connecte via le port TCP 8100 au serveur VMM nommé VMMServer01 situé dans le domaine Contoso.

Exemple 3 : Se connecter à un serveur VMM et obtenir son type d’objet, ses méthodes et ses propriétés .NET

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

La première commande obtient l’objet serveur VMM nommé VMMServer01 et stocke l’objet dans la variable $VMMServer.

La deuxième commande transmet l’objet serveur VMM stocké dans $VMMServer à l’applet de commande Get-Member , qui récupère et affiche les éléments suivants :

  • TypeName : nom de type .NET de l’objet serveur VMM : Microsoft.SystemCenter.VirtualMachineManager.Remoting.ServerConnection

  • MemberType : liste contenant le nom et la définition de chaque événement, méthode et propriété associés à ce type d’objet.

La troisième commande récupère et affiche les mêmes informations que la deuxième commande, sauf qu’elle dirige la sortie vers l’applet de commande Format-List pour afficher la définition complète de chaque méthode et chaque propriété de l’objet serveur VMM.

Exemple 4 : Se connecter à un autre serveur VMM avec un autre rôle d’utilisateur

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

Cette commande se connecte au serveur VMM nommé VMMServer02 situé dans le domaine Contoso à l’aide du rôle d’utilisateur DelegatedAdmin.

Paramètres

-AllowJobGC

Indique que le garbage collection est autorisé pour les travaux.

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

-ComputerName

Spécifie le nom d’un ordinateur que VMM peut identifier de manière unique sur votre réseau. Les valeurs valides pour ce paramètre sont :

  • FQDN
  • Adresse IPv4 ou IPv6
  • Nom NetBIOS
Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ConnectAs

Spécifie le rôle d’utilisateur VMM à utiliser, si l’utilisateur est membre de plusieurs rôles, lors de la connexion au serveur d’administration VMM à partir de l’interpréteur de commandes VMM. Les valeurs valides pour ce paramètre sont :

  • Administrateur
  • DelegatedAdmin
  • ReadOnlyAdmin
  • SelfServiceUser

Les administrateurs VMM peuvent gérer tous les objets VMM. Les administrateurs délégués et les utilisateurs libre-service peuvent accéder et modifier uniquement les objets qui se trouvent dans l’étendue de leurs rôles d’utilisateur. Read-Only administrateurs ne peuvent afficher que les propriétés des objets existants ; ils ne peuvent pas créer de nouveaux objets ou modifier les propriétés des objets existants.

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

Spécifie un objet d’informations d’identification ou, pour certaines applets de commande, un objet de compte d’identification qui contient le nom d’utilisateur et le mot de passe d’un compte autorisé à effectuer cette action. Ou, dans le cas de Restart-SCJob, dispose de l’autorisation d’effectuer une tâche redémarrée.

Pour plus d’informations sur l’objet PSCredential , tapez Get-Help Get-Credential.

Pour plus d’informations sur les comptes d’identification, tapez Get-Help New-SCRunAsAccount.

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

-ForOnBehalfOf

Indique qu’un administrateur est en mesure d’utiliser les paramètres OnBehalfOf , lorsqu’il est disponible, pour les applets de commande VMM. Ce paramètre est principalement utilisé pour les connexions Service Provider Foundation à VMM.

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

-RetainDeletedObjects

Spécifie que les objets du cache marqués pour suppression seront conservés. Vous n’avez peut-être besoin de ce paramètre que si vous créez une interface utilisateur au-dessus de l’interpréteur de commandes VMM.

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

-RetainObjectCache

Indique que les objets du cache restent en mémoire et ne sont pas récupérés par le garbage collection. Vous aurez peut-être besoin de ce paramètre si vous créez une interface utilisateur sur l’interpréteur de commandes VMM.

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

-SetAsDefault

Indique, lorsqu’il est défini sur $True, que l’interpréteur de commandes VMM se connecte au serveur d’administration VMM spécifié pour cette session et conserve cette connexion pour les sessions futures.

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

-TCPPort

Spécifie une valeur numérique qui représente un port TCP.

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

-UserRoleName

Spécifie le nom d’un rôle d’utilisateur. Les types de rôles d’utilisateur nommés sont les suivants :

  • Administrateur délégué
  • Administrateur en lecture seule
  • Utilisateur libre-service
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False