Get-SCVMMServer
Se connecte à un serveur de gestion VMM si aucune connexion n’existe déjà, ou se connecte à un autre serveur de gestion VMM.
Syntaxe
Default (Par défaut)
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 de gestion VMM (Virtual Machine Manager) si aucune connexion n’existe 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 de gestion VMM à l’aide de l’interface utilisateur, lorsque vous ouvrez un interpréteur de commandes VMM, celui-ci se connecte automatiquement au même serveur de gestion VMM. Si vous ne vous êtes pas encore connecté au serveur de gestion VMM à l’aide de l’interface utilisateur, vous devez utiliser Get-SCVMMServer pour établir une connexion. Notez que si vous vous connectez à un serveur de gestion VMM uniquement à l’aide de l’interpréteur de commandes VMM, vous devez utiliser le paramètre SetAsDefault pour conserver la connexion d’une session à l’autre 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 de gestion VMM.
Une fois qu’une connexion au serveur de gestion VMM est établie, toutes les commandes futures exécutées sur la ligne de commande de l’interpréteur de commandes VMM qui nécessitent l’objet serveur VMM utiliseront automatiquement la connexion existante jusqu’à ce que vous fermiez cette fenêtre de l’interpréteur de commandes VMM.
Le service VMM exécuté sur le serveur de gestion VMM prend en charge la base de données VMM. Cette base de données est stockée dans Microsoft SQL Server soit sur le serveur de gestion VMM lui-même, soit 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 (qui hébergent les machines virtuelles), 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 de gestion 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 récupère 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 seconde, sauf qu’elle achemine la sortie vers l’applet de commande Format-List pour afficher la définition complète de chaque méthode et de chaque propriété de l’objet serveur VMM.
Exemple 4 : Se connecter à un autre serveur VMM avec un rôle d’utilisateur différent
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 nettoyage de la mémoire est autorisé pour les travaux.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ComputerName
Spécifie le nom d’un ordinateur que VMM peut identifier de manière unique sur votre réseau. Les valeurs acceptables pour ce paramètre sont les suivantes :
- nom de domaine pleinement qualifié (FQDN)
- Adresse IPv4 ou IPv6
- Nom NetBIOS
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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 de gestion VMM à partir de l’interpréteur de commandes VMM. Les valeurs acceptables pour ce paramètre sont les suivantes :
- Administrateur
- DéléguéAdmin
- ReadOnlyAdmin
- SelfServiceUser
Les administrateurs VMM peuvent gérer tous les objets VMM. Les administrateurs délégués et les utilisateurs en libre-service ne peuvent accéder et modifier que les objets qui se trouvent dans le cadre 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 d’objets existants.
Propriétés du paramètre
| Type: | Profile |
| Valeur par défaut: | None |
| Valeurs acceptées: | Administrator, DelegatedAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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, a 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.
Propriétés du paramètre
| Type: | PSCredential |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ForOnBehalfOf
Indique qu’un administrateur est en mesure d’utiliser les paramètres OnBehalfOf , lorsqu’ils sont disponibles, pour les applets de commande VMM. Ce paramètre est principalement utilisé pour les connexions Service Provider Foundation à VMM.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RetainDeletedObjects
Spécifie que les objets du cache marqués pour suppression seront conservés. Vous n’aurez peut-être besoin de ce paramètre que si vous créez une interface utilisateur au-dessus de l’interpréteur de commandes VMM.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RetainObjectCache
Indique que les objets du cache resteront en mémoire et ne seront pas récupérés par le nettoyage de la mémoire. Vous pouvez avoir besoin de ce paramètre si vous créez une interface utilisateur au-dessus de l’interpréteur de commandes VMM.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SetAsDefault
Indique, lorsqu’il est défini sur $True, que l’interpréteur de commandes VMM se connecte au serveur de gestion VMM spécifié pour cette session et conserve cette connexion pour les sessions futures.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-TCPPort
Spécifie une valeur numérique qui représente un port TCP.
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Port |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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 Read-Only
- Self-Service Utilisateur
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.