Set-SCVMMServer

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

Syntax

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 Virtual Machine Manager (VMM). Les paramètres VMM que vous pouvez modifier avec l’applet de commande Set-SCVMMServer sont les 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ée.

Participation au Programme d’amélioration du produit élaboré par Microsoft

Vous pouvez utiliser Set-SCVMMServer pour spécifier s’il faut activer les métriques de qualité de service (SQ) 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.

Contrôle à distance

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 des utilisateurs libre-service

Vous pouvez utiliser Set-SCVMMServer pour spécifier l’adresse de messagerie d’un administrateur qui prend en charge les utilisateurs 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 utilisateur (CEIP) Microsoft 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 AdminHelp@Contoso.com de messagerie de contact libre-service sur VMMServer01.

Paramètres

-AttestationServerUrl

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

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

-AutomaticLogicalNetworkCreationEnabled

Indique si les réseaux logiques sont créés automatiquement. Lorsqu’il est défini sur $True, un 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 réseau virtuel est créé.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Accepted values:Disabled, FirstDNSSuffixLabel, DNSSuffix, NetworkConnectionName, VirtualNetworkSwitchName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DiagnosticsAndUsageData

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

-JobVariable

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

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

-KeyProtectionServerUrl

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

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

-LibraryRefresherEnabled

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

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

-LibraryRefresherFrequency

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

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

-LogicalNetworkMatch

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

  • Désactivé
  • FirstDNSSuffixLabel
  • DNSSuffix
  • NetworkConnectionName
  • VirtualNetworkSwitchName
Type:LogicalNetworkMatchOption
Accepted values:Disabled, FirstDNSSuffixLabel, DNSSuffix, NetworkConnectionName, VirtualNetworkSwitchName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PortACL

Spécifie un objet ACL de port.

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

-RemovePortACL

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

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

-RunAsynchronously

Indique que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

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

-ShieldingHelperVhd

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

-VMConnectDefaultPort

Spécifie la valeur par défaut du port TCP utilisé pour les sessions VMConnect sur tous les ordinateurs hôtes Hyper-V gérés par ce serveur VMM. En général, 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMConnectGatewayCertificatePassword

Spécifie le mot de passe du certificat de passerelle sous la forme d’une 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMConnectGatewayCertificatePath

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

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

-VMConnectHostIdentificationMode

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

  • FQDN
  • IPv4
  • IPv6
  • HostName
Type:VMConnectHostIDMode
Accepted values:FQDN, IPv4, IPv6, HostName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMConnectHyperVCertificatePassword

Spécifie le mot de passe du 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMConnectHyperVCertificatePath

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

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

-VMConnectNCCertificatePassword

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

-VMConnectNCCertificatePath

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

-VMMServer

Spécifie un objet serveur VMM.

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

-VMSubnetIDRangeEnd

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

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

Sorties

VMMServer

Cette applet de commande retourne un objet VMMServer .