VBoxManage dhcpserver modify |
Modifie le serveur DHCP |
|---|---|
| VirtualBox | |
Syntaxe
| VBoxManage dhcpserver modify --network=netname | --interface=ifname [--server-ip=address] [--lower-ip=address] [--upper-ip=address] [--netmask=mask] [ --enable | --disable ] [[--global] [--del-opt=dhcp-opt-no...] [--set-opt=dhcp-opt-no value...] [--set-opt-hex=dhcp-opt-no hexstring...] [--force-opt=dhcp-opt-no...] [--unforce-opt=dhcp-opt-no...] [--supress-opt=dhcp-opt-no...] [--unsupress-opt=dhcp-opt-no...] [--min-lease-time=seconds] [--default-lease-time=seconds] [--max-lease-time=seconds] [--remove-config]...] [--group=name [--set-opt=dhcp-opt-no value...] [--set-opt-hex=dhcp-opt-no hexstring...] [--force-opt=dhcp-opt-no...] [--unforce-opt=dhcp-opt-no...] [--supress-opt=dhcp-opt-no...] [--unsupress-opt=dhcp-opt-no...] [--del-mac=address...] [--incl-mac=address...] [--excl-mac=address...] [--del-mac-wild=pattern...] [--incl-mac-wild=pattern...] [--excl-mac-wild=pattern...] [--del-vendor=string...] [--incl-vendor=string...] [--excl-vendor=string...] [--del-vendor-wild=pattern...] [--incl-vendor-wild=pattern...] [--excl-vendor-wild=pattern...] [--del-user=string...] [--incl-user=string...] [--excl-user=string...] [--del-user-wild=pattern...] [--incl-user-wild=pattern...] [--excl-user-wild=pattern...] [--zap-conditions] [--min-lease-time=seconds] [--default-lease-time=seconds] [--max-lease-time=seconds] [--remove-config]...] [--vm=name|uuid [--nic=1-N] [--del-opt=dhcp-opt-no...] [--set-opt=dhcp-opt-no value...] [--set-opt-hex=dhcp-opt-no hexstring...] [--force-opt=dhcp-opt-no...] [--unforce-opt=dhcp-opt-no...] [--supress-opt=dhcp-opt-no...] [--unsupress-opt=dhcp-opt-no...] [--min-lease-time=seconds] [--default-lease-time=seconds] [--max-lease-time=seconds] [--fixed-address=address] [--remove-config]...] [--mac-address=address [--del-opt=dhcp-opt-no...] [--set-opt=dhcp-opt-no value...] [--set-opt-hex=dhcp-opt-no hexstring...] [--force-opt=dhcp-opt-no...] [--unforce-opt=dhcp-opt-no...] [--supress-opt=dhcp-opt-no...] [--unsupress-opt=dhcp-opt-no...] [--min-lease-time=seconds] [--default-lease-time=seconds] [--max-lease-time=seconds] [--fixed-address=address] [--remove-config]...] |
Paramètres
| Nom | Description |
|---|---|
| --server-ip=address | Ce paramètre permet d'indiquer l'adresse IP que le serveur DHCP doit utiliser. |
| --lower-ip=address | Ce paramètre permet d'indiquer l'intervalle inférieure d'adresses IP que le serveur DHCP doit gérer. Il ne doit pas inclure l'adresse du serveur DHCP lui-même, mais il doit être dans le même réseau que lui. Les bibliothèques de délimitation sont inclusives, de sorte que les adresses inférieure et supérieure seront distribuées aux clients. |
| --upper-ip=address | Ce paramètre permet d'indiquer l'intervalle supérieure d'adresses IP que le serveur DHCP doit gérer. Il ne doit pas inclure l'adresse du serveur DHCP lui-même, mais il doit être dans le même réseau que lui. Les bibliothèques de délimitation sont inclusives, de sorte que les adresses inférieure et supérieure seront distribuées aux clients. |
| --netmask=mask | Ce paramètre permet d'indiquer le masque de réseau. Généralement 255.255.255.0. |
| --disable | Ce paramètre permet désactiver le serveur DHCP. S'il n'est pas spécifié, le serveur sera créé dans l'état désactivé et aucune adresse IP ne sera distribuée. |
| --enable | Ce paramètre permet d'activer le serveur DHCP. S'il n'est pas spécifié, le serveur sera créé dans l'état désactivé et aucune adresse IP ne sera distribuée. |
| Options sélectionnant la portée : | |
| --global | Ce paramètre permet de définir la portée de la configuration sur globale. Toutes les options suivantes de --set-opt s'appliqueront à tous les clients DHCP. |
| --vm=vmname|uuid | Ce paramètre permet de définir la portée de la configuration sur la première carte réseau de la machine virtuelle spécifiée. Toutes les options suivantes --set-opt ne s'appliqueront qu'à cette interface, rien d'autre. |
| --nic=1-N | Ce paramètre permet de définir la portée de la configuration sur une carte réseau autre que la première de la machine virtuelle spécifiée dans --vm. |
| --mac-address=address | Ce paramètre permet de définir la portée de la configuration sur l'adresse MAC spécifiée. |
| --group=name | Ce paramètre permet de définir la portée de la configuration sur le groupe spécifié. |
| Options configurant l'étendue actuellement sélectionnée : | |
| --set-opt=dhcp-opt-no value | Ce paramètre permet d'ajouter le numéro d'option DHCP (0 à 255) et la valeur spécifiés. Le format de la valeur est spécifique à l'option (généralement lisible par l'homme) et sera validé par l'API et le serveur DHCP. |
| --set-opt-hex=dhcp-opt-no hexstring | Ce paramètre permet d'ajouter le numéro d'option DHCP (0 à 255) et la valeur spécifiés. La valeur de l'option est spécifiée sous la forme d'une série brute d'octets hexadécimaux, éventuellement séparés par des deux-points. Aucune validation n'est effectuée sur ceux-ci par l'API ou le serveur DHCP, ils seront transmis comme spécifié au client. |
| --force-opt=dhcp-opt-no | Ce paramètre permet de forcer le numéro d'option DHCP spécifié (0 à 255) à être envoyé au client, qu'il l'ait demandé ou non (à condition que l'option soit configurée avec une valeur à un certain niveau). |
| --suppress-opt=dhcp-opt-no | Ce paramètre permet d'empêcher le numéro d'option DHCP spécifié (0 à 255) d'être envoyé au client lorsqu'il est présent dans cette étendue ou dans une étendue de configuration élevée. |
| --min-lease-time=seconds | Ce paramètre permet de définir la durée de bail minimale de l'étendue actuelle en secondes. Zéro signifie prendre la valeur d'un niveau d'option supérieur ou utiliser la valeur par défaut. |
| --default-lease-time=seconds | Ce paramètre permet de définir la durée de bail par défaut de l'étendue actuelle en secondes. Zéro signifie prendre la valeur d'un niveau d'option supérieur ou utiliser la valeur par défaut. |
| --max-lease-time=seconds | Ce paramètre permet de définir la durée de bail maximale de l'étendue actuelle en secondes. Zéro signifie prendre la valeur d'un niveau d'option supérieur ou utiliser la valeur par défaut. |
| --fixed-address=address | Ce paramètre permet d'indiquer l'attribution d'adresse fixe pour une étendue de configuration --vm ou --mac-address. Toute adresse vide la ramène à l'attribution d'adresse dynamique. |
| Options de configuration des conditions d'appartenance au groupe (exclut les remplacements, comprend) : | |
| --incl-mac=address | Ce paramètre permet d'inclure l'adresse MAC spécifique dans le groupe. |
| --excl-mac=address | Ce paramètre permet d'exclure l'adresse MAC spécifique du groupe. |
| --incl-mac-wild=pattern | Ce paramètre permet d'inclure le modèle d'adresse MAC spécifique dans le groupe. |
| --excl-mac-wild=pattern | Ce paramètre permet d'exclure le modèle d'adresse MAC spécifique du groupe. |
| --incl-vendor=string | Ce paramètre permet d'inclure l'identificateur de classe de fournisseur spécifique dans le groupe. |
| --excl-vendor=string | Ce paramètre permet d'exclure l'identificateur de classe de fournisseur spécifique du groupe. |
| --incl-vendor-wild=pattern | Ce paramètre permet d'inclure le modèle d'identificateur de classe de fournisseur spécifique dans le groupe. |
| --excl-vendor-wild=pattern | Ce paramètre permet d'exclure le modèle d'identificateur de classe de fournisseur spécifique du groupe. |
| --incl-user=string | Ce paramètre permet d'inclure l'identificateur de classe d'utilisateurs spécifique dans le groupe. |
| --excl-user=string | Ce paramètre permet d'exclure l'identificateur de classe d'utilisateurs spécifique du groupe. |
| --incl-user-wild=pattern | Ce paramètre permet d'inclure le modèle d'identificateur de classe d'utilisateurs spécifique dans le groupe. |
| --excl-user-wild=pattern | Ce paramètre permet d'exclure le modèle d'identificateur de classe d'utilisateurs spécifique du groupe. |
| Options de modification d'une configuration de serveur DHCP existante : | |
| --del-opt=dhcp-opt-no | Ce paramètre permet d'entraîner la suppression du numéro d'option DHCP spécifié (0 à 255) des paramètres du serveur. Comme avec --set-opt, la portée de la suppression est régie par les options --global, --vm, --mac-address et --group. |
| --unforce-opt=dhcp-opt-no | Ce paramètre permet de supprimer le numéro d'option DHCP spécifié (0 à 255) de la liste d'options forcées (c'est-à-dire l'inverse de --force-opt). Comme avec --set-opt, la portée de la suppression est régie par les options --global, --vm, --mac-address et --group. |
| --unsuppress-opt=dhcp-opt-no | Ce paramètre permet de supprimer le numéro d'option DHCP spécifié (0 à 255) de la liste d'options supprimées (c'est-à-dire l'inverse de --suppress-opt). Comme avec --set-opt, la portée de la suppression est régie par les options --global, --vm, --mac-address et --group. |
| --remove-config | Ce paramètre permet de supprimer la configuration en cours de délimitation. La portée --global n'est pas amovible. La portée de la configuration passera à --global après cette option. |
| Options de condition d'appartenance au groupe : | |
| --del-mac=address | Ce paramètre permet de supprimer l'adresse MAC spécifique des conditions de groupe. |
| --del-mac-wild=pattern | Ce paramètre permet de supprimer le modèle d'adresse MAC spécifique des conditions de groupe. |
| --del-vendor=string | Ce paramètre permet de supprimer l'identificateur de classe de fournisseur spécifique des conditions de groupe. |
| --del-vendor-wild=pattern | Ce paramètre permet de supprimer le modèle d'identificateur de classe de fournisseur spécifique des conditions de groupe. |
| --del-user=string | Ce paramètre permet de supprimer le modèle d'identificateur de classe d'utilisateurs spécifique des conditions de groupe. |
| --del-user-wild=pattern | Ce paramètre permet de supprimer le modèle d'identificateur de classe d'utilisateurs spécifique des conditions de groupe. |
| --zap-conditions | Ce paramètre permet de supprimer toutes les conditions de groupe. |
Description
Cette commande permet de modifier une configuration de serveur DHCP existante.
Remarque
- Voici la liste des numéro d'options DHCP courantes :
| Numéro | Identificateur | Description |
|---|---|---|
| 1 | SubnetMask | Masque de réseau IPv4. Défini sur la valeur de l'option --netmask par défaut. |
| 2 | TimeOffset | Décalage UTC en secondes (valeur décimale 32 bits). |
| 3 | Routers | Liste d'adresses de routeur IPv4 séparées par des espaces. |
| 4 | TimeServers | Liste des adresses de serveur de temps IPv4 séparées par des espaces (RFC 868). |
| 5 | NameServers | Liste des adresses de serveur de noms IPv4 (IEN 116) séparées par des espaces. |
| 6 | DomainNameServers | Liste d'adresses DNS en IPv4 séparées par des espaces. |
| 7 | LogServers | Liste des adresses de serveur de journaux IPv4 séparées par des espaces. |
| 8 | CookieServers | Liste des adresses de serveur de cookies IPv4 séparées par des espaces (RFC 865). |
| 9 | LPRServers | Liste des adresses de serveur d'affichage de ligne IPv4 séparées par des espaces (RFC 1179). |
| 10 | ImpressServers | Liste des adresses IPv4 séparées par des espaces pour impressionner les serveurs. |
| 11 | ResourseLocationServers | Liste des adresses d'emplacement de ressources IPv4 (RFC 887) séparées par des espaces. |
| 12 | HostName | Le nom du client. Voir RFC 1035 pour les limites de caractères. |
| 13 | BootFileSize | Nombre de blocs de 512 octets constituant le fichier de démarrage (valeur décimale 16 bits). |
| 14 | MeritDumpFile | Fichier du coeur client. |
| 15 | DomainName | Nom de domaine du client. |
| 16 | SwapServer | Adresse IPv4 du serveur d'échange que le client doit utiliser. |
| 17 | RootPath | Le chemin d'accès au disque racine que le client doit utiliser. |
| 18 | ExtensionPath | Chemin vers un fichier contenant des options DHCP supplémentaires (RFC2123). |
| 19 | IPForwarding | Si le transfert IP doit être activé par le client (booléen). |
| 20 | OptNonLocalSourceRouting | Si les datagrammes non locaux doivent être transmis par le client (booléen) |
| 21 | PolicyFilter | Liste des adresses IPv4 et des masques paris contrôlant le routage source non local. |
| 22 | MaxDgramReassemblySize | La taille maximale du datagramme que le client doit réassembler (valeur décimale 16 bits). |
| 23 | DefaultIPTTL | Délai de sortie par défaut sur les datagrammes sortants (IP) (valeur décimale 8 bits). |
| 24 | PathMTUAgingTimeout | Chemin RFC1191 de valeur du délai de découverte MTU en secondes (valeur décimale 32 bits). |
| 25 | PathMTUPlateauTable | Table des tailles de découverte MTU du chemin RFC1191, triée par ordre croissant (liste de valeurs décimales 16 bits). |
| 26 | InterfaceMTU | La taille MTU de l'interface (valeur décimale 16 bits). |
| 27 | AllSubnetsAreLocal | Indique si la taille MTU est la même pour tous les sous-réseaux (booléen). |
| 28 | BroadcastAddress | Adresse de diffusion (RFC1122) à utiliser par le client (adresse IPv4). |
| 29 | PerformMaskDiscovery | S'il faut effectuer la découverte du masque de sous-réseau via ICMP (booléen). |
| 30 | MaskSupplier | Indique s'il faut répondre aux demandes de masque de sous-réseau via ICMP (booléen). |
| 31 | PerformRouterDiscovery | S'il faut effectuer la découverte de routeur (RFC1256) (booléen). |
| 32 | RouterSolicitationAddress | Où envoyer les demandes de sollicitation de routeur (RFC1256) (adresse IPv4). |
| 33 | StaticRoute | Liste des adresses des paires d'adresses réseau et routeur. |
| 34 | TrailerEncapsulation | S'il faut négocier l'utilisation des remorques pour ARP (RTF893) (booléen). |
| 35 | ARPCacheTimeout | Délai d'expiration en secondes pour les entrées de cache ARP (valeur décimale de 32 bits). |
| 36 | EthernetEncapsulation | S'il faut utiliser l'encapsulation Ethernet IEEE 802.3 (RTF1042) plutôt que v2 (RFC894) (booléen). |
| 37 | TCPDefaultTTL | Durée de vie par défaut pour les envois TCP (valeur décimale 8 bits différente de zéro). |
| 38 | TCPKeepaliveInterval | L'interface en secondes entre les messages TCP keepalive (valeur décimale 32 bits). |
| 39 | TCPKeepaliveGarbage | Indique s'il faut inclure un octet de déchets dans les messages TCP keepalive pour une compatibilité descendante (booléen). |
| 40 | NISDomain | Le nom de domaine NIS (Sun Network Information Services) (chaîne de caractères). |
| 41 | NISServers | Liste des adresses de serveur NIS IPv4 séparées par des espaces. |
| 42 | NTPServers | Liste des adresses de serveur IPv4 NTP (RFC1035) séparées par des espaces. |
| 43 | VendorSpecificInfo | Informations spécifiques au fournisseur. Uniquement accessible en utilisant --set-opt-hex. |
| 44 | NetBIOSNameServers | Liste des adresses de serveur de noms NetBIOS (NBNS) IPv4 séparées par des espaces (RFC1001, RFC1002). |
| 45 | NetBIOSDatagramServers | Liste des adresses du serveur de distribution de datagrammes NetBIOS IPv4 (NBDD) séparées par des espaces (RFC1001, RFC1002). |
| 46 | NetBIOSNodeType | Type de noeud NetBIOS (RFC1001, RFC1002): 1 = noeud B, 2 = noeud P, 4 = noeud M et 8 = noeud H (valeur décimale 8 bits). |
| 47 | NetBIOSScope | Portée NetBIOS (RFC1001, RFC1002). Uniquement accessible en utilisant --set-opt-hex. |
| 48 | XWindowsFontServers | Liste des adresses de serveur de polices de caractères X Windows de IPv4 séparées par des espaces. |
| 49 | XWindowsDisplayManager | Liste des adresses du gestionnaire d'affichage X Windows en IPv4 séparées par des espaces. |
| 62 | NetWareIPDomainName | Nom de domaine NetWare IP (RFC2242) (chaîne de caractères). |
| 63 | NetWareIPInformation | Informations Netware IP (RFC2242). Uniquement accessible en utilisant --set-opt-hex. |
| 64 | NISPlusDomain | Le nom de domaine NIS+ (chaîne de caractères). |
| 65 | NISPlusServers | Liste des adresses de serveur NIS+ en IPv4 séparées par des espaces. |
| 66 | TFTPServerName | Nom du serveur TFTP (chaîne de caractères). |
| 67 | BootfileName | Nom du fichier de démarrage (chaîne de caractères). |
| 68 | MobileIPHomeAgents | Liste des adresses d'agent IP mobile IPv4 séparées par des espaces. |
| 69 | SMTPServers | Liste des adresses de serveur SMTP (Simple Mail Transport Protocol) IPv4, séparées par des espaces. |
| 70 | POP3Servers | Liste des adresses de serveur POP3 (IPv4 post office protocol 3) séparées par des espaces. |
| 71 | NNTPServers | Liste des adresses de serveur NTTP (Network News Transport Protocol) IPv4 séparées par des espaces. |
| 72 | WWWServers | Liste des adresses de serveur WWW (World Wide Web) IPv4 séparées par des espaces. |
| 73 | FingerServers | Liste séparée par des espaces des adresses de serveur finger IPv4 par défaut. |
| 74 | IRCServers | Liste des adresses de serveur IRC (Internet Relay Chat) IPv4, séparées par des espaces. |
| 75 | StreetTalkServers | Liste des adresses de serveur IPv4 StreetTalk séparées par des espaces. |
| 76 | STDAServers | Liste des adresses de serveur d'assistance de répertoire StreetTalk (STDA) en IPv4 séparées par des espaces. |
| 78 | SLPDirectoryAgent | Adresses d'un ou plusieurs agents de répertoire SLP (Service Location Protocol) et indicateur indiquant si leur utilisation est obligatoire. Uniquement accessible en utilisant --set-opt-hex. |
| 79 | SLPServiceScope | Liste des étendues de service pour le protocole de localisation de service (SLP) et si l'utilisation de la liste est obligatoire. Uniquement accessible en utilisant --set-opt-hex. |
| 119 | DomainSearch | Liste de recherche de domaine, voir RFC3397 dans RFC1035 pour l'encodage. Uniquement accessible en utilisant --set-opt-hex. |
Dernière mise à jour : Jeudi, le 25 Février 2021