Partager via

Set-SCVMMServer

  • Référence
Module:
VirtualMachineManager

Modifie les propriétés du serveur d’administration VMM.

Syntaxe

Set-SCVMMServer
   [-DiagnosticsAndUsageData <Boolean>]
   [-VMRCAccessAccount <String>]
   [-VMRCDefaultPort <UInt32>]
   [-VMConnectDefaultPort <UInt32>]
   [-LibraryRefresherEnabled <Boolean>]
   [-LibraryRefresherFrequency <UInt16>]
   [-AutomaticLogicalNetworkCreationEnabled <Boolean>]
   [-LogicalNetworkMatch <LogicalNetworkMatchOption>]
   [-BackupLogicalNetworkMatch <LogicalNetworkMatchOption>]
   [-AutomaticVirtualNetworkCreationEnabled <Boolean>]
   [-VMSubnetIDRangeStart <UInt32>]
   [-VMSubnetIDRangeEnd <UInt32>]
   [-VMConnectTimeToLiveInMinutes <Int32>]
   [-VMConnectGatewayCertificatePath <String>]
   [-VMConnectGatewayCertificatePassword <SecureString>]
   [-VMConnectHyperVCertificatePath <String>]
   [-VMConnectHyperVCertificatePassword <SecureString>]
   [-VMConnectNCCertificatePath <String>]
   [-VMConnectNCCertificatePassword <SecureString>]
   [-VMConnectHostIdentificationMode <VMConnectHostIDMode>]
   [-KeyProtectionServerUrl <String>]
   [-AttestationServerUrl <String>]
   [-ShieldingHelperVhd <VirtualHardDisk>]
   [-VMMServer <ServerConnection>]
   [-PortACL <PortACL>]
   [-RemovePortACL]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

L’applet de commande Set-SCVMMServer modifie une ou plusieurs propriétés du serveur d’administration VMM (Virtual Machine Manager). Les paramètres VMM que vous pouvez modifier avec l’applet de commande Set-SCVMMServer incluent les éléments suivants :

Configurer l’authentification fédérée

Vous pouvez utiliser les paramètres fournis avec Set-SCVMMServer pour configurer l’authentification fédérée. L’authentification fédérée permet à un utilisateur de se connecter à la console d’une machine virtuelle sans avoir d’informations d’identification sur l’ordinateur hôte Hyper-V. Utilisez l’applet de commande New-SCVMConnectFedAuth pour émettre des jetons d’authentification fédérés.

Participation au Programme d’amélioration de l’expérience client Microsoft (CEIP)

Vous pouvez utiliser Set-SCVMMServer pour spécifier s’il faut activer les métriques de qualité de service (M²) pour ce serveur d’administration VMM.

Paramètres de la bibliothèque

Vous pouvez utiliser Set-SCVMMServer pour spécifier si l’actualisation de la bibliothèque VMM est activée et, le cas échéant, la fréquence à laquelle les objets de la bibliothèque sont actualisés.

Paramètres réseau

Vous pouvez utiliser l’applet de commande Set-VMMServer pour configurer la correspondance des réseaux logiques. Vous pouvez également activer la création automatique de réseaux logiques et virtuels.

Télécommande

Vous pouvez utiliser Set-SCVMMServer pour configurer le port de contrôle à distance par défaut à utiliser lors de la connexion à des machines virtuelles (VMConnect).

Contact pour les utilisateurs Self-Service

Vous pouvez utiliser Set-SCVMMServer pour spécifier l’adresse de messagerie d’un administrateur qui prend en charge les utilisateurs en libre-service.

Paramètres de l’agent invité

Vous pouvez utiliser Set-SCVMMServer pour sélectionner la méthode utilisée pour communiquer avec l’agent invité VMM : nom de domaine complet ou adresse IP.

Exemples

Exemple 1 : Définir la fréquence à laquelle la bibliothèque est actualisée

PS C:\> Set-SCVMMServer -VMMServer "VMMServer01.Contoso.com" -LibraryRefresherEnabled $True -LibraryRefresherFrequency 24

Cette commande active l’actualisation de la bibliothèque pour VMMServer01 et définit le taux de fréquence d’actualisation toutes les 24 heures.

Exemple 2 : Refuser le programme d’amélioration de l’expérience utilisateur

PS C:\> Set-SCVMMServer -VMMServer "VMMServer01.Contoso.com" -CEIPOptIn $False

Cette commande désactive la participation au Programme d’amélioration de l’expérience client Microsoft (CEIP) en définissant le paramètre CEIPOptIn sur $False sur VMMServer01.

Exemple 3 : Spécifier une adresse de messagerie de contact libre-service

PS C:\> Set-SCVMMServer -VMMServer "VMMServer01.Contoso.com" -SelfServiceContactEmail "AdminHelp@Contoso.com"

Cette commande définit l’adresse e-mail du contact libre-service sur AdminHelp@Contoso.com sur VMMServer01.

Paramètres

-AttestationServerUrl

Spécifie l’URL du serveur d’attestation.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AutomaticLogicalNetworkCreationEnabled

Indique si les réseaux logiques sont créés automatiquement. Lorsqu’il est défini sur $True, un nouveau réseau logique est créé, en fonction des paramètres de correspondance de réseau logique, si la carte réseau hôte n’est pas associée à un réseau logique.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AutomaticVirtualNetworkCreationEnabled

Indique si les réseaux virtuels sont créés automatiquement. Lorsqu’il est défini sur $True, si un hôte dispose d’une carte réseau pour le placement associé à un réseau logique, mais qu’aucun réseau virtuel n’est attaché à la carte, un nouveau réseau virtuel est créé.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-BackupLogicalNetworkMatch

Spécifie la méthode de correspondance réseau à utiliser si la méthode de correspondance réseau principale n’est pas disponible.

Type:LogicalNetworkMatchOption
Valeurs acceptées:Disabled, FirstDNSSuffixLabel, DNSSuffix, NetworkConnectionName, VirtualNetworkSwitchName
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DiagnosticsAndUsageData

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-JobVariable

Spécifie que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-KeyProtectionServerUrl

Spécifie l’URL du serveur de protection de clés (KPS).

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-LibraryRefresherEnabled

Indique, lorsqu’il est défini sur $True, que les objets de bibliothèque VMM sont actualisés.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-LibraryRefresherFrequency

Spécifie, en heures, la fréquence à laquelle les objets de la bibliothèque VMM sont actualisés. Le paramètre par défaut est 1 heure.

Type:UInt16
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-LogicalNetworkMatch

Spécifie la méthode de correspondance de réseau logique à utiliser pour créer automatiquement des réseaux logiques. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Handicapé
  • FirstDNSSuffixLabel
  • DNSSuffix
  • NetworkConnectionName
  • VirtualNetworkSwitchName
Type:LogicalNetworkMatchOption
Valeurs acceptées:Disabled, FirstDNSSuffixLabel, DNSSuffix, NetworkConnectionName, VirtualNetworkSwitchName
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PortACL

Spécifie un objet ACL de port.

Type:PortACL
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PROTipID

Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils pro.

Type:Guid
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RemovePortACL

Indique que cette opération supprime la liste de contrôle d’accès aux ports (ACL).

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RunAsynchronously

Indique que le travail s’exécute de façon asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ShieldingHelperVhd

Type:VirtualHardDisk
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VMConnectDefaultPort

Spécifie la valeur par défaut pour le port TCP utilisé pour les sessions de connexion de machine virtuelle (VMConnect) sur tous les hôtes Hyper-V gérés par ce serveur VMM. En règle générale, le port par défaut est 2179, mais vous pouvez utiliser ce paramètre pour modifier la valeur par défaut. Ce paramètre ne s’applique pas aux hôtes VMware ESX Server ou aux hôtes Citrix XenServer.

Type:UInt32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VMConnectGatewayCertificatePassword

Spécifie le mot de passe du certificat de passerelle en tant que chaîne sécurisée. Vous devez spécifier une valeur pour ce paramètre lorsque le paramètre VMConnectGatewayCertificatePath est spécifié.

Type:SecureString
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VMConnectGatewayCertificatePath

Spécifie le chemin d’accès à un certificat de clé privée (fichier.pfx).

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VMConnectHostIdentificationMode

Spécifie la façon dont l’hôte Hyper-V est identifié. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • FQDN
  • IPv4
  • IPv6
  • Nom d’hôte
Type:VMConnectHostIDMode
Valeurs acceptées:FQDN, IPv4, IPv6, HostName
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VMConnectHyperVCertificatePassword

Spécifie le mot de passe de certificat Hyper-V en tant que chaîne sécurisée. Vous devez spécifier une valeur pour ce paramètre lorsque le paramètre VMConnectHyperVCertificatePath est spécifié.

Type:SecureString
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VMConnectHyperVCertificatePath

Spécifie le chemin d’accès à un certificat de clé privée (fichier.pfx).

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VMConnectNCCertificatePassword

Type:SecureString
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VMConnectNCCertificatePath

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VMConnectTimeToLiveInMinutes

Spécifie, en minutes, la période de validité pour laquelle les jetons sont des problèmes. Les valeurs valides sont comprises entre 1 et 60.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VMMServer

Spécifie un objet serveur VMM.

Type:ServerConnection
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-VMRCAccessAccount

Spécifie le compte à utiliser lors de la connexion à une machine virtuelle à l’aide du contrôle à distance de machine virtuelle (VMRC).

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VMRCDefaultPort

Spécifie le port par défaut à utiliser lors de la connexion à une machine virtuelle à l’aide de VMRC.

Type:UInt32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VMSubnetIDRangeEnd

Spécifie l’ID de fin d’une plage d’ID de sous-réseau de machine virtuelle.

Type:UInt32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VMSubnetIDRangeStart

Spécifie l’ID de départ d’une plage d’ID de sous-réseau de machine virtuelle.

Type:UInt32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Sorties

VMMServer

Cette applet de commande retourne un objet VMMServer.