pulumi-vsphere 4.11.0a1__py3-none-any.whl → 4.11.0a1711033215__py3-none-any.whl

pulumi_vsphere/distributed_virtual_switch.py

@@ -114,17 +114,29 @@ class DistributedVirtualSwitchArgs:
         The set of arguments for constructing a DistributedVirtualSwitch resource.
         :param pulumi.Input[str] datacenter_id: The ID of the datacenter where the VDS will be
                created. Forces a new resource if changed.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] active_uplinks: List of active uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
-        :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than
-               that of its own.
-        :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access Control (MAC) address can be changed.
-        :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] active_uplinks: A list of active uplinks to be used in load
+               balancing. These uplinks need to match the definitions in the
+               `uplinks` VDS argument. See
+               here for more details.
+        :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not a virtual
+               network adapter is allowed to send network traffic with a different MAC
+               address than that of its own.
+        :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access
+               Control (MAC) address can be changed.
+        :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This
+               flag indicates whether or not all traffic is seen on a given port.
         :param pulumi.Input[int] backupnfc_maximum_mbit: The maximum allowed usage for the backupNfc traffic class, in Mbits/sec.
         :param pulumi.Input[int] backupnfc_reservation_mbit: The amount of guaranteed bandwidth for the backupNfc traffic class, in Mbits/sec.
         :param pulumi.Input[int] backupnfc_share_count: The amount of shares to allocate to the backupNfc traffic class for a custom share level.
         :param pulumi.Input[str] backupnfc_share_level: The allocation level for the backupNfc traffic class. Can be one of high, low, normal, or custom.
-        :param pulumi.Input[bool] block_all_ports: Indicates whether to block all ports by default.
-        :param pulumi.Input[bool] check_beacon: Enable beacon probing on the ports this policy applies to.
+        :param pulumi.Input[bool] block_all_ports: Shuts down all ports in the port groups that
+               this policy applies to, effectively blocking all network access to connected
+               virtual devices.
+        :param pulumi.Input[bool] check_beacon: Enables beacon probing as an additional measure
+               to detect NIC failure.
+               
+               > **NOTE:** VMware recommends using a minimum of 3 NICs when using beacon
+               probing.
         :param pulumi.Input[str] contact_detail: The detailed contact information for the person
                who is responsible for the VDS.
         :param pulumi.Input[str] contact_name: The name of the person who is responsible for the
@@ -135,12 +147,18 @@ class DistributedVirtualSwitchArgs:
                > **NOTE:** Custom attributes are unsupported on direct ESXi host connections
                and requires vCenter Server.
         :param pulumi.Input[str] description: A detailed description for the VDS.
-        :param pulumi.Input[bool] directpath_gen2_allowed: Allow VMDirectPath Gen2 on the ports this policy applies to.
-        :param pulumi.Input[int] egress_shaping_average_bandwidth: The average egress bandwidth in bits per second if egress shaping is enabled on the port.
-        :param pulumi.Input[int] egress_shaping_burst_size: The maximum egress burst size allowed in bytes if egress shaping is enabled on the port.
-        :param pulumi.Input[bool] egress_shaping_enabled: True if the traffic shaper is enabled for egress traffic on the port.
-        :param pulumi.Input[int] egress_shaping_peak_bandwidth: The peak egress bandwidth during bursts in bits per second if egress traffic shaping is enabled on the port.
-        :param pulumi.Input[bool] failback: If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
+        :param pulumi.Input[bool] directpath_gen2_allowed: Allow VMDirectPath Gen2 for the ports
+               for which this policy applies to.
+        :param pulumi.Input[int] egress_shaping_average_bandwidth: The average bandwidth in bits
+               per second if egress traffic shaping is enabled on the port.
+        :param pulumi.Input[int] egress_shaping_burst_size: The maximum burst size allowed in
+               bytes if egress traffic shaping is enabled on the port.
+        :param pulumi.Input[bool] egress_shaping_enabled: `true` if the traffic shaper is enabled
+               on the port for egress traffic.
+        :param pulumi.Input[int] egress_shaping_peak_bandwidth: The peak bandwidth during bursts
+               in bits per second if egress traffic shaping is enabled on the port.
+        :param pulumi.Input[bool] failback: If `true`, the teaming policy will re-activate failed
+               uplinks higher in precedence when they come back up.
         :param pulumi.Input[int] faulttolerance_maximum_mbit: The maximum allowed usage for the faultTolerance traffic class, in Mbits/sec.
         :param pulumi.Input[int] faulttolerance_reservation_mbit: The amount of guaranteed bandwidth for the faultTolerance traffic class, in Mbits/sec.
         :param pulumi.Input[int] faulttolerance_share_count: The amount of shares to allocate to the faultTolerance traffic class for a custom share level.
@@ -151,12 +169,18 @@ class DistributedVirtualSwitchArgs:
         :param pulumi.Input[int] hbr_reservation_mbit: The amount of guaranteed bandwidth for the hbr traffic class, in Mbits/sec.
         :param pulumi.Input[int] hbr_share_count: The amount of shares to allocate to the hbr traffic class for a custom share level.
         :param pulumi.Input[str] hbr_share_level: The allocation level for the hbr traffic class. Can be one of high, low, normal, or custom.
-        :param pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchHostArgs']]] hosts: A host member specification.
-        :param pulumi.Input[bool] ignore_other_pvlan_mappings: Whether to ignore existing PVLAN mappings not managed by this resource. Defaults to false.
-        :param pulumi.Input[int] ingress_shaping_average_bandwidth: The average ingress bandwidth in bits per second if ingress shaping is enabled on the port.
-        :param pulumi.Input[int] ingress_shaping_burst_size: The maximum ingress burst size allowed in bytes if ingress shaping is enabled on the port.
-        :param pulumi.Input[bool] ingress_shaping_enabled: True if the traffic shaper is enabled for ingress traffic on the port.
-        :param pulumi.Input[int] ingress_shaping_peak_bandwidth: The peak ingress bandwidth during bursts in bits per second if ingress traffic shaping is enabled on the port.
+        :param pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchHostArgs']]] hosts: Use the `host` block to declare a host specification. The
+               options are:
+        :param pulumi.Input[bool] ignore_other_pvlan_mappings: Whether to ignore existing PVLAN
+               mappings not managed by this resource. Defaults to false.
+        :param pulumi.Input[int] ingress_shaping_average_bandwidth: The average bandwidth in
+               bits per second if ingress traffic shaping is enabled on the port.
+        :param pulumi.Input[int] ingress_shaping_burst_size: The maximum burst size allowed in
+               bytes if ingress traffic shaping is enabled on the port.
+        :param pulumi.Input[bool] ingress_shaping_enabled: `true` if the traffic shaper is
+               enabled on the port for ingress traffic.
+        :param pulumi.Input[int] ingress_shaping_peak_bandwidth: The peak bandwidth during
+               bursts in bits per second if ingress traffic shaping is enabled on the port.
         :param pulumi.Input[str] ipv4_address: An IPv4 address to identify the switch. This is
                mostly useful when used with the Netflow arguments.
         :param pulumi.Input[int] iscsi_maximum_mbit: The maximum allowed usage for the iSCSI traffic class, in Mbits/sec.
@@ -166,8 +190,9 @@ class DistributedVirtualSwitchArgs:
         :param pulumi.Input[str] lacp_api_version: The Link Aggregation Control Protocol group
                version to use with the VDS. Possible values are `singleLag` and
                `multipleLag`.
-        :param pulumi.Input[bool] lacp_enabled: Whether or not to enable LACP on all uplink ports.
-        :param pulumi.Input[str] lacp_mode: The uplink LACP mode to use. Can be one of active or passive.
+        :param pulumi.Input[bool] lacp_enabled: Enables LACP for the ports that this policy
+               applies to.
+        :param pulumi.Input[str] lacp_mode: The LACP mode. Can be one of `active` or `passive`.
         :param pulumi.Input[str] link_discovery_operation: Whether to `advertise` or `listen`
                for link discovery traffic.
         :param pulumi.Input[str] link_discovery_protocol: The discovery protocol type. Valid
@@ -180,35 +205,60 @@ class DistributedVirtualSwitchArgs:
         :param pulumi.Input[str] multicast_filtering_mode: The multicast filtering mode to use
                with the VDS. Can be one of `legacyFiltering` or `snooping`.
         :param pulumi.Input[str] name: The name of the VDS.
-        :param pulumi.Input[int] netflow_active_flow_timeout: The number of seconds after which active flows are forced to be exported to the collector.
-        :param pulumi.Input[str] netflow_collector_ip_address: IP address for the netflow collector, using IPv4 or IPv6. IPv6 is supported in vSphere Distributed Switch Version 6.0 or
-               later.
-        :param pulumi.Input[int] netflow_collector_port: The port for the netflow collector.
-        :param pulumi.Input[bool] netflow_enabled: Indicates whether to enable netflow on all ports.
-        :param pulumi.Input[int] netflow_idle_flow_timeout: The number of seconds after which idle flows are forced to be exported to the collector.
-        :param pulumi.Input[bool] netflow_internal_flows_only: Whether to limit analysis to traffic that has both source and destination served by the same host.
-        :param pulumi.Input[int] netflow_observation_domain_id: The observation Domain ID for the netflow collector.
-        :param pulumi.Input[int] netflow_sampling_rate: The ratio of total number of packets to the number of packets analyzed. Set to 0 to disable sampling, meaning that all
-               packets are analyzed.
-        :param pulumi.Input[bool] network_resource_control_enabled: Whether or not to enable network resource control, enabling advanced traffic shaping and resource control features.
-        :param pulumi.Input[str] network_resource_control_version: The network I/O control version to use. Can be one of version2 or version3.
+        :param pulumi.Input[int] netflow_active_flow_timeout: The number of seconds after which
+               active flows are forced to be exported to the collector. Allowed range is
+               `60` to `3600`. Default: `60`.
+        :param pulumi.Input[str] netflow_collector_ip_address: IP address for the Netflow
+               collector, using IPv4 or IPv6. IPv6 is supported in VDS version 6.0 or later.
+               Must be set before Netflow can be enabled.
+        :param pulumi.Input[int] netflow_collector_port: Port for the Netflow collector. This
+               must be set before Netflow can be enabled.
+        :param pulumi.Input[bool] netflow_enabled: Enables Netflow on all ports that this policy
+               applies to.
+        :param pulumi.Input[int] netflow_idle_flow_timeout: The number of seconds after which
+               idle flows are forced to be exported to the collector. Allowed range is `10`
+               to `600`. Default: `15`.
+        :param pulumi.Input[bool] netflow_internal_flows_only: Whether to limit analysis to
+               traffic that has both source and destination served by the same host.
+               Default: `false`.
+        :param pulumi.Input[int] netflow_observation_domain_id: The observation domain ID for
+               the Netflow collector.
+        :param pulumi.Input[int] netflow_sampling_rate: The ratio of total number of packets to
+               the number of packets analyzed. The default is `0`, which indicates that the
+               VDS should analyze all packets. The maximum value is `1000`, which
+               indicates an analysis rate of 0.001%!
+               (MISSING)
+        :param pulumi.Input[bool] network_resource_control_enabled: Set to `true` to enable
+               network I/O control. Default: `false`.
+        :param pulumi.Input[str] network_resource_control_version: The version of network I/O
+               control to use. Can be one of `version2` or `version3`. Default: `version2`.
         :param pulumi.Input[int] nfs_maximum_mbit: The maximum allowed usage for the nfs traffic class, in Mbits/sec.
         :param pulumi.Input[int] nfs_reservation_mbit: The amount of guaranteed bandwidth for the nfs traffic class, in Mbits/sec.
         :param pulumi.Input[int] nfs_share_count: The amount of shares to allocate to the nfs traffic class for a custom share level.
         :param pulumi.Input[str] nfs_share_level: The allocation level for the nfs traffic class. Can be one of high, low, normal, or custom.
-        :param pulumi.Input[bool] notify_switches: If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
-        :param pulumi.Input[int] port_private_secondary_vlan_id: The secondary VLAN ID for this port.
-        :param pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchPvlanMappingArgs']]] pvlan_mappings: A private VLAN (PVLAN) mapping.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_uplinks: List of standby uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
+        :param pulumi.Input[bool] notify_switches: If `true`, the teaming policy will notify the
+               broadcast network of an uplink failover, triggering cache updates.
+        :param pulumi.Input[int] port_private_secondary_vlan_id: Used to define a secondary VLAN
+               ID when using private VLANs.
+        :param pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchPvlanMappingArgs']]] pvlan_mappings: Use the `pvlan_mapping` block to declare a
+               private VLAN mapping. The options are:
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_uplinks: A list of standby uplinks to be used in
+               failover. These uplinks need to match the definitions in the
+               `uplinks` VDS argument. See
+               here for more details.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource.
                
                > **NOTE:** Tagging support requires vCenter Server 6.0 or higher.
-        :param pulumi.Input[str] teaming_policy: The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid,
-               failover_explicit, or loadbalance_loadbased.
-        :param pulumi.Input[bool] tx_uplink: If true, a copy of packets sent to the switch will always be forwarded to an uplink in addition to the regular packet
-               forwarded done by the switch.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] uplinks: A list of uplink ports. The contents of this list control both the uplink count and names of the uplinks on the DVS
-               across hosts.
+        :param pulumi.Input[str] teaming_policy: The uplink teaming policy. Can be one of
+               `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`,
+               `failover_explicit`, or `loadbalance_loadbased`.
+        :param pulumi.Input[bool] tx_uplink: Forward all traffic transmitted by ports for which
+               this policy applies to its VDS uplinks.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] uplinks: A list of strings that uniquely identifies the names
+               of the uplinks on the VDS across hosts. The number of items in this list
+               controls the number of uplinks that exist on the VDS, in addition to the
+               names. See here for an example on how to
+               use this option.
         :param pulumi.Input[int] vdp_maximum_mbit: The maximum allowed usage for the vdp traffic class, in Mbits/sec.
         :param pulumi.Input[int] vdp_reservation_mbit: The amount of guaranteed bandwidth for the vdp traffic class, in Mbits/sec.
         :param pulumi.Input[int] vdp_share_count: The amount of shares to allocate to the vdp traffic class for a custom share level.
@@ -221,7 +271,28 @@ class DistributedVirtualSwitchArgs:
         :param pulumi.Input[int] virtualmachine_share_count: The amount of shares to allocate to the virtualMachine traffic class for a custom share level.
         :param pulumi.Input[str] virtualmachine_share_level: The allocation level for the virtualMachine traffic class. Can be one of high, low, normal, or custom.
         :param pulumi.Input[int] vlan_id: The VLAN ID for single VLAN mode. 0 denotes no VLAN.
-        :param pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchVlanRangeArgs']]] vlan_ranges: The VLAN ID for single VLAN mode. 0 denotes no VLAN.
+        :param pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchVlanRangeArgs']]] vlan_ranges: Used to denote VLAN trunking. Use the `min_vlan`
+               and `max_vlan` sub-arguments to define the tagged VLAN range. Multiple
+               `vlan_range` definitions are allowed, but they must not overlap. Example
+               below:
+               
+               <!--Start PulumiCodeChooser -->
+               ```python
+               import pulumi
+               import pulumi_vsphere as vsphere
+               
+               vds = vsphere.DistributedVirtualSwitch("vds", vlan_ranges=[
+                   vsphere.DistributedVirtualSwitchVlanRangeArgs(
+                       max_vlan=199,
+                       min_vlan=100,
+                   ),
+                   vsphere.DistributedVirtualSwitchVlanRangeArgs(
+                       max_vlan=399,
+                       min_vlan=300,
+                   ),
+               ])
+               ```
+               <!--End PulumiCodeChooser -->
         :param pulumi.Input[int] vmotion_maximum_mbit: The maximum allowed usage for the vmotion traffic class, in Mbits/sec.
         :param pulumi.Input[int] vmotion_reservation_mbit: The amount of guaranteed bandwidth for the vmotion traffic class, in Mbits/sec.
         :param pulumi.Input[int] vmotion_share_count: The amount of shares to allocate to the vmotion traffic class for a custom share level.
@@ -436,7 +507,10 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="activeUplinks")
     def active_uplinks(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
-        List of active uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
+        A list of active uplinks to be used in load
+        balancing. These uplinks need to match the definitions in the
+        `uplinks` VDS argument. See
+        here for more details.
         """
         return pulumi.get(self, "active_uplinks")
 
@@ -448,8 +522,9 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="allowForgedTransmits")
     def allow_forged_transmits(self) -> Optional[pulumi.Input[bool]]:
         """
-        Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than
-        that of its own.
+        Controls whether or not a virtual
+        network adapter is allowed to send network traffic with a different MAC
+        address than that of its own.
         """
         return pulumi.get(self, "allow_forged_transmits")
 
@@ -461,7 +536,8 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="allowMacChanges")
     def allow_mac_changes(self) -> Optional[pulumi.Input[bool]]:
         """
-        Controls whether or not the Media Access Control (MAC) address can be changed.
+        Controls whether or not the Media Access
+        Control (MAC) address can be changed.
         """
         return pulumi.get(self, "allow_mac_changes")
 
@@ -473,7 +549,8 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="allowPromiscuous")
     def allow_promiscuous(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
+        Enable promiscuous mode on the network. This
+        flag indicates whether or not all traffic is seen on a given port.
         """
         return pulumi.get(self, "allow_promiscuous")
 
@@ -533,7 +610,9 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="blockAllPorts")
     def block_all_ports(self) -> Optional[pulumi.Input[bool]]:
         """
-        Indicates whether to block all ports by default.
+        Shuts down all ports in the port groups that
+        this policy applies to, effectively blocking all network access to connected
+        virtual devices.
         """
         return pulumi.get(self, "block_all_ports")
 
@@ -545,7 +624,11 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="checkBeacon")
     def check_beacon(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable beacon probing on the ports this policy applies to.
+        Enables beacon probing as an additional measure
+        to detect NIC failure.
+
+        > **NOTE:** VMware recommends using a minimum of 3 NICs when using beacon
+        probing.
         """
         return pulumi.get(self, "check_beacon")
 
@@ -611,7 +694,8 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="directpathGen2Allowed")
     def directpath_gen2_allowed(self) -> Optional[pulumi.Input[bool]]:
         """
-        Allow VMDirectPath Gen2 on the ports this policy applies to.
+        Allow VMDirectPath Gen2 for the ports
+        for which this policy applies to.
         """
         return pulumi.get(self, "directpath_gen2_allowed")
 
@@ -623,7 +707,8 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="egressShapingAverageBandwidth")
     def egress_shaping_average_bandwidth(self) -> Optional[pulumi.Input[int]]:
         """
-        The average egress bandwidth in bits per second if egress shaping is enabled on the port.
+        The average bandwidth in bits
+        per second if egress traffic shaping is enabled on the port.
         """
         return pulumi.get(self, "egress_shaping_average_bandwidth")
 
@@ -635,7 +720,8 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="egressShapingBurstSize")
     def egress_shaping_burst_size(self) -> Optional[pulumi.Input[int]]:
         """
-        The maximum egress burst size allowed in bytes if egress shaping is enabled on the port.
+        The maximum burst size allowed in
+        bytes if egress traffic shaping is enabled on the port.
         """
         return pulumi.get(self, "egress_shaping_burst_size")
 
@@ -647,7 +733,8 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="egressShapingEnabled")
     def egress_shaping_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        True if the traffic shaper is enabled for egress traffic on the port.
+        `true` if the traffic shaper is enabled
+        on the port for egress traffic.
         """
         return pulumi.get(self, "egress_shaping_enabled")
 
@@ -659,7 +746,8 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="egressShapingPeakBandwidth")
     def egress_shaping_peak_bandwidth(self) -> Optional[pulumi.Input[int]]:
         """
-        The peak egress bandwidth during bursts in bits per second if egress traffic shaping is enabled on the port.
+        The peak bandwidth during bursts
+        in bits per second if egress traffic shaping is enabled on the port.
         """
         return pulumi.get(self, "egress_shaping_peak_bandwidth")
 
@@ -671,7 +759,8 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter
     def failback(self) -> Optional[pulumi.Input[bool]]:
         """
-        If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
+        If `true`, the teaming policy will re-activate failed
+        uplinks higher in precedence when they come back up.
         """
         return pulumi.get(self, "failback")
 
@@ -792,7 +881,8 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter
     def hosts(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchHostArgs']]]]:
         """
-        A host member specification.
+        Use the `host` block to declare a host specification. The
+        options are:
         """
         return pulumi.get(self, "hosts")
 
@@ -804,7 +894,8 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="ignoreOtherPvlanMappings")
     def ignore_other_pvlan_mappings(self) -> Optional[pulumi.Input[bool]]:
         """
-        Whether to ignore existing PVLAN mappings not managed by this resource. Defaults to false.
+        Whether to ignore existing PVLAN
+        mappings not managed by this resource. Defaults to false.
         """
         return pulumi.get(self, "ignore_other_pvlan_mappings")
 
@@ -816,7 +907,8 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="ingressShapingAverageBandwidth")
     def ingress_shaping_average_bandwidth(self) -> Optional[pulumi.Input[int]]:
         """
-        The average ingress bandwidth in bits per second if ingress shaping is enabled on the port.
+        The average bandwidth in
+        bits per second if ingress traffic shaping is enabled on the port.
         """
         return pulumi.get(self, "ingress_shaping_average_bandwidth")
 
@@ -828,7 +920,8 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="ingressShapingBurstSize")
     def ingress_shaping_burst_size(self) -> Optional[pulumi.Input[int]]:
         """
-        The maximum ingress burst size allowed in bytes if ingress shaping is enabled on the port.
+        The maximum burst size allowed in
+        bytes if ingress traffic shaping is enabled on the port.
         """
         return pulumi.get(self, "ingress_shaping_burst_size")
 
@@ -840,7 +933,8 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="ingressShapingEnabled")
     def ingress_shaping_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        True if the traffic shaper is enabled for ingress traffic on the port.
+        `true` if the traffic shaper is
+        enabled on the port for ingress traffic.
         """
         return pulumi.get(self, "ingress_shaping_enabled")
 
@@ -852,7 +946,8 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="ingressShapingPeakBandwidth")
     def ingress_shaping_peak_bandwidth(self) -> Optional[pulumi.Input[int]]:
         """
-        The peak ingress bandwidth during bursts in bits per second if ingress traffic shaping is enabled on the port.
+        The peak bandwidth during
+        bursts in bits per second if ingress traffic shaping is enabled on the port.
         """
         return pulumi.get(self, "ingress_shaping_peak_bandwidth")
 
@@ -939,7 +1034,8 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="lacpEnabled")
     def lacp_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        Whether or not to enable LACP on all uplink ports.
+        Enables LACP for the ports that this policy
+        applies to.
         """
         return pulumi.get(self, "lacp_enabled")
 
@@ -951,7 +1047,7 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="lacpMode")
     def lacp_mode(self) -> Optional[pulumi.Input[str]]:
         """
-        The uplink LACP mode to use. Can be one of active or passive.
+        The LACP mode. Can be one of `active` or `passive`.
         """
         return pulumi.get(self, "lacp_mode")
 
@@ -1074,7 +1170,9 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="netflowActiveFlowTimeout")
     def netflow_active_flow_timeout(self) -> Optional[pulumi.Input[int]]:
         """
-        The number of seconds after which active flows are forced to be exported to the collector.
+        The number of seconds after which
+        active flows are forced to be exported to the collector. Allowed range is
+        `60` to `3600`. Default: `60`.
         """
         return pulumi.get(self, "netflow_active_flow_timeout")
 
@@ -1086,8 +1184,9 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="netflowCollectorIpAddress")
     def netflow_collector_ip_address(self) -> Optional[pulumi.Input[str]]:
         """
-        IP address for the netflow collector, using IPv4 or IPv6. IPv6 is supported in vSphere Distributed Switch Version 6.0 or
-        later.
+        IP address for the Netflow
+        collector, using IPv4 or IPv6. IPv6 is supported in VDS version 6.0 or later.
+        Must be set before Netflow can be enabled.
         """
         return pulumi.get(self, "netflow_collector_ip_address")
 
@@ -1099,7 +1198,8 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="netflowCollectorPort")
     def netflow_collector_port(self) -> Optional[pulumi.Input[int]]:
         """
-        The port for the netflow collector.
+        Port for the Netflow collector. This
+        must be set before Netflow can be enabled.
         """
         return pulumi.get(self, "netflow_collector_port")
 
@@ -1111,7 +1211,8 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="netflowEnabled")
     def netflow_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        Indicates whether to enable netflow on all ports.
+        Enables Netflow on all ports that this policy
+        applies to.
         """
         return pulumi.get(self, "netflow_enabled")
 
@@ -1123,7 +1224,9 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="netflowIdleFlowTimeout")
     def netflow_idle_flow_timeout(self) -> Optional[pulumi.Input[int]]:
         """
-        The number of seconds after which idle flows are forced to be exported to the collector.
+        The number of seconds after which
+        idle flows are forced to be exported to the collector. Allowed range is `10`
+        to `600`. Default: `15`.
         """
         return pulumi.get(self, "netflow_idle_flow_timeout")
 
@@ -1135,7 +1238,9 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="netflowInternalFlowsOnly")
     def netflow_internal_flows_only(self) -> Optional[pulumi.Input[bool]]:
         """
-        Whether to limit analysis to traffic that has both source and destination served by the same host.
+        Whether to limit analysis to
+        traffic that has both source and destination served by the same host.
+        Default: `false`.
         """
         return pulumi.get(self, "netflow_internal_flows_only")
 
@@ -1147,7 +1252,8 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="netflowObservationDomainId")
     def netflow_observation_domain_id(self) -> Optional[pulumi.Input[int]]:
         """
-        The observation Domain ID for the netflow collector.
+        The observation domain ID for
+        the Netflow collector.
         """
         return pulumi.get(self, "netflow_observation_domain_id")
 
@@ -1159,8 +1265,11 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="netflowSamplingRate")
     def netflow_sampling_rate(self) -> Optional[pulumi.Input[int]]:
         """
-        The ratio of total number of packets to the number of packets analyzed. Set to 0 to disable sampling, meaning that all
-        packets are analyzed.
+        The ratio of total number of packets to
+        the number of packets analyzed. The default is `0`, which indicates that the
+        VDS should analyze all packets. The maximum value is `1000`, which
+        indicates an analysis rate of 0.001%!
+        (MISSING)
         """
         return pulumi.get(self, "netflow_sampling_rate")
 
@@ -1172,7 +1281,8 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="networkResourceControlEnabled")
     def network_resource_control_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        Whether or not to enable network resource control, enabling advanced traffic shaping and resource control features.
+        Set to `true` to enable
+        network I/O control. Default: `false`.
         """
         return pulumi.get(self, "network_resource_control_enabled")
 
@@ -1184,7 +1294,8 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="networkResourceControlVersion")
     def network_resource_control_version(self) -> Optional[pulumi.Input[str]]:
         """
-        The network I/O control version to use. Can be one of version2 or version3.
+        The version of network I/O
+        control to use. Can be one of `version2` or `version3`. Default: `version2`.
         """
         return pulumi.get(self, "network_resource_control_version")
 
@@ -1244,7 +1355,8 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="notifySwitches")
     def notify_switches(self) -> Optional[pulumi.Input[bool]]:
         """
-        If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
+        If `true`, the teaming policy will notify the
+        broadcast network of an uplink failover, triggering cache updates.
         """
         return pulumi.get(self, "notify_switches")
 
@@ -1256,7 +1368,8 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="portPrivateSecondaryVlanId")
     def port_private_secondary_vlan_id(self) -> Optional[pulumi.Input[int]]:
         """
-        The secondary VLAN ID for this port.
+        Used to define a secondary VLAN
+        ID when using private VLANs.
         """
         return pulumi.get(self, "port_private_secondary_vlan_id")
 
@@ -1268,7 +1381,8 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="pvlanMappings")
     def pvlan_mappings(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchPvlanMappingArgs']]]]:
         """
-        A private VLAN (PVLAN) mapping.
+        Use the `pvlan_mapping` block to declare a
+        private VLAN mapping. The options are:
         """
         return pulumi.get(self, "pvlan_mappings")
 
@@ -1280,7 +1394,10 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="standbyUplinks")
     def standby_uplinks(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
-        List of standby uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
+        A list of standby uplinks to be used in
+        failover. These uplinks need to match the definitions in the
+        `uplinks` VDS argument. See
+        here for more details.
         """
         return pulumi.get(self, "standby_uplinks")
 
@@ -1306,8 +1423,9 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="teamingPolicy")
     def teaming_policy(self) -> Optional[pulumi.Input[str]]:
         """
-        The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid,
-        failover_explicit, or loadbalance_loadbased.
+        The uplink teaming policy. Can be one of
+        `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`,
+        `failover_explicit`, or `loadbalance_loadbased`.
         """
         return pulumi.get(self, "teaming_policy")
 
@@ -1319,8 +1437,8 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="txUplink")
     def tx_uplink(self) -> Optional[pulumi.Input[bool]]:
         """
-        If true, a copy of packets sent to the switch will always be forwarded to an uplink in addition to the regular packet
-        forwarded done by the switch.
+        Forward all traffic transmitted by ports for which
+        this policy applies to its VDS uplinks.
         """
         return pulumi.get(self, "tx_uplink")
 
@@ -1332,8 +1450,11 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter
     def uplinks(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
-        A list of uplink ports. The contents of this list control both the uplink count and names of the uplinks on the DVS
-        across hosts.
+        A list of strings that uniquely identifies the names
+        of the uplinks on the VDS across hosts. The number of items in this list
+        controls the number of uplinks that exist on the VDS, in addition to the
+        names. See here for an example on how to
+        use this option.
         """
         return pulumi.get(self, "uplinks")
 
@@ -1467,7 +1588,28 @@ class DistributedVirtualSwitchArgs:
     @pulumi.getter(name="vlanRanges")
     def vlan_ranges(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchVlanRangeArgs']]]]:
         """
-        The VLAN ID for single VLAN mode. 0 denotes no VLAN.
+        Used to denote VLAN trunking. Use the `min_vlan`
+        and `max_vlan` sub-arguments to define the tagged VLAN range. Multiple
+        `vlan_range` definitions are allowed, but they must not overlap. Example
+        below:
+
+        <!--Start PulumiCodeChooser -->
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+
+        vds = vsphere.DistributedVirtualSwitch("vds", vlan_ranges=[
+            vsphere.DistributedVirtualSwitchVlanRangeArgs(
+                max_vlan=199,
+                min_vlan=100,
+            ),
+            vsphere.DistributedVirtualSwitchVlanRangeArgs(
+                max_vlan=399,
+                min_vlan=300,
+            ),
+        ])
+        ```
+        <!--End PulumiCodeChooser -->
         """
         return pulumi.get(self, "vlan_ranges")
 
@@ -1672,17 +1814,29 @@ class _DistributedVirtualSwitchState:
                  vsan_share_level: Optional[pulumi.Input[str]] = None):
         """
         Input properties used for looking up and filtering DistributedVirtualSwitch resources.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] active_uplinks: List of active uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
-        :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than
-               that of its own.
-        :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access Control (MAC) address can be changed.
-        :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] active_uplinks: A list of active uplinks to be used in load
+               balancing. These uplinks need to match the definitions in the
+               `uplinks` VDS argument. See
+               here for more details.
+        :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not a virtual
+               network adapter is allowed to send network traffic with a different MAC
+               address than that of its own.
+        :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access
+               Control (MAC) address can be changed.
+        :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This
+               flag indicates whether or not all traffic is seen on a given port.
         :param pulumi.Input[int] backupnfc_maximum_mbit: The maximum allowed usage for the backupNfc traffic class, in Mbits/sec.
         :param pulumi.Input[int] backupnfc_reservation_mbit: The amount of guaranteed bandwidth for the backupNfc traffic class, in Mbits/sec.
         :param pulumi.Input[int] backupnfc_share_count: The amount of shares to allocate to the backupNfc traffic class for a custom share level.
         :param pulumi.Input[str] backupnfc_share_level: The allocation level for the backupNfc traffic class. Can be one of high, low, normal, or custom.
-        :param pulumi.Input[bool] block_all_ports: Indicates whether to block all ports by default.
-        :param pulumi.Input[bool] check_beacon: Enable beacon probing on the ports this policy applies to.
+        :param pulumi.Input[bool] block_all_ports: Shuts down all ports in the port groups that
+               this policy applies to, effectively blocking all network access to connected
+               virtual devices.
+        :param pulumi.Input[bool] check_beacon: Enables beacon probing as an additional measure
+               to detect NIC failure.
+               
+               > **NOTE:** VMware recommends using a minimum of 3 NICs when using beacon
+               probing.
         :param pulumi.Input[str] config_version: The current version of the VDS configuration, incremented
                by subsequent updates to the VDS.
         :param pulumi.Input[str] contact_detail: The detailed contact information for the person
@@ -1697,12 +1851,18 @@ class _DistributedVirtualSwitchState:
         :param pulumi.Input[str] datacenter_id: The ID of the datacenter where the VDS will be
                created. Forces a new resource if changed.
         :param pulumi.Input[str] description: A detailed description for the VDS.
-        :param pulumi.Input[bool] directpath_gen2_allowed: Allow VMDirectPath Gen2 on the ports this policy applies to.
-        :param pulumi.Input[int] egress_shaping_average_bandwidth: The average egress bandwidth in bits per second if egress shaping is enabled on the port.
-        :param pulumi.Input[int] egress_shaping_burst_size: The maximum egress burst size allowed in bytes if egress shaping is enabled on the port.
-        :param pulumi.Input[bool] egress_shaping_enabled: True if the traffic shaper is enabled for egress traffic on the port.
-        :param pulumi.Input[int] egress_shaping_peak_bandwidth: The peak egress bandwidth during bursts in bits per second if egress traffic shaping is enabled on the port.
-        :param pulumi.Input[bool] failback: If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
+        :param pulumi.Input[bool] directpath_gen2_allowed: Allow VMDirectPath Gen2 for the ports
+               for which this policy applies to.
+        :param pulumi.Input[int] egress_shaping_average_bandwidth: The average bandwidth in bits
+               per second if egress traffic shaping is enabled on the port.
+        :param pulumi.Input[int] egress_shaping_burst_size: The maximum burst size allowed in
+               bytes if egress traffic shaping is enabled on the port.
+        :param pulumi.Input[bool] egress_shaping_enabled: `true` if the traffic shaper is enabled
+               on the port for egress traffic.
+        :param pulumi.Input[int] egress_shaping_peak_bandwidth: The peak bandwidth during bursts
+               in bits per second if egress traffic shaping is enabled on the port.
+        :param pulumi.Input[bool] failback: If `true`, the teaming policy will re-activate failed
+               uplinks higher in precedence when they come back up.
         :param pulumi.Input[int] faulttolerance_maximum_mbit: The maximum allowed usage for the faultTolerance traffic class, in Mbits/sec.
         :param pulumi.Input[int] faulttolerance_reservation_mbit: The amount of guaranteed bandwidth for the faultTolerance traffic class, in Mbits/sec.
         :param pulumi.Input[int] faulttolerance_share_count: The amount of shares to allocate to the faultTolerance traffic class for a custom share level.
@@ -1713,12 +1873,18 @@ class _DistributedVirtualSwitchState:
         :param pulumi.Input[int] hbr_reservation_mbit: The amount of guaranteed bandwidth for the hbr traffic class, in Mbits/sec.
         :param pulumi.Input[int] hbr_share_count: The amount of shares to allocate to the hbr traffic class for a custom share level.
         :param pulumi.Input[str] hbr_share_level: The allocation level for the hbr traffic class. Can be one of high, low, normal, or custom.
-        :param pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchHostArgs']]] hosts: A host member specification.
-        :param pulumi.Input[bool] ignore_other_pvlan_mappings: Whether to ignore existing PVLAN mappings not managed by this resource. Defaults to false.
-        :param pulumi.Input[int] ingress_shaping_average_bandwidth: The average ingress bandwidth in bits per second if ingress shaping is enabled on the port.
-        :param pulumi.Input[int] ingress_shaping_burst_size: The maximum ingress burst size allowed in bytes if ingress shaping is enabled on the port.
-        :param pulumi.Input[bool] ingress_shaping_enabled: True if the traffic shaper is enabled for ingress traffic on the port.
-        :param pulumi.Input[int] ingress_shaping_peak_bandwidth: The peak ingress bandwidth during bursts in bits per second if ingress traffic shaping is enabled on the port.
+        :param pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchHostArgs']]] hosts: Use the `host` block to declare a host specification. The
+               options are:
+        :param pulumi.Input[bool] ignore_other_pvlan_mappings: Whether to ignore existing PVLAN
+               mappings not managed by this resource. Defaults to false.
+        :param pulumi.Input[int] ingress_shaping_average_bandwidth: The average bandwidth in
+               bits per second if ingress traffic shaping is enabled on the port.
+        :param pulumi.Input[int] ingress_shaping_burst_size: The maximum burst size allowed in
+               bytes if ingress traffic shaping is enabled on the port.
+        :param pulumi.Input[bool] ingress_shaping_enabled: `true` if the traffic shaper is
+               enabled on the port for ingress traffic.
+        :param pulumi.Input[int] ingress_shaping_peak_bandwidth: The peak bandwidth during
+               bursts in bits per second if ingress traffic shaping is enabled on the port.
         :param pulumi.Input[str] ipv4_address: An IPv4 address to identify the switch. This is
                mostly useful when used with the Netflow arguments.
         :param pulumi.Input[int] iscsi_maximum_mbit: The maximum allowed usage for the iSCSI traffic class, in Mbits/sec.
@@ -1728,8 +1894,9 @@ class _DistributedVirtualSwitchState:
         :param pulumi.Input[str] lacp_api_version: The Link Aggregation Control Protocol group
                version to use with the VDS. Possible values are `singleLag` and
                `multipleLag`.
-        :param pulumi.Input[bool] lacp_enabled: Whether or not to enable LACP on all uplink ports.
-        :param pulumi.Input[str] lacp_mode: The uplink LACP mode to use. Can be one of active or passive.
+        :param pulumi.Input[bool] lacp_enabled: Enables LACP for the ports that this policy
+               applies to.
+        :param pulumi.Input[str] lacp_mode: The LACP mode. Can be one of `active` or `passive`.
         :param pulumi.Input[str] link_discovery_operation: Whether to `advertise` or `listen`
                for link discovery traffic.
         :param pulumi.Input[str] link_discovery_protocol: The discovery protocol type. Valid
@@ -1742,35 +1909,60 @@ class _DistributedVirtualSwitchState:
         :param pulumi.Input[str] multicast_filtering_mode: The multicast filtering mode to use
                with the VDS. Can be one of `legacyFiltering` or `snooping`.
         :param pulumi.Input[str] name: The name of the VDS.
-        :param pulumi.Input[int] netflow_active_flow_timeout: The number of seconds after which active flows are forced to be exported to the collector.
-        :param pulumi.Input[str] netflow_collector_ip_address: IP address for the netflow collector, using IPv4 or IPv6. IPv6 is supported in vSphere Distributed Switch Version 6.0 or
-               later.
-        :param pulumi.Input[int] netflow_collector_port: The port for the netflow collector.
-        :param pulumi.Input[bool] netflow_enabled: Indicates whether to enable netflow on all ports.
-        :param pulumi.Input[int] netflow_idle_flow_timeout: The number of seconds after which idle flows are forced to be exported to the collector.
-        :param pulumi.Input[bool] netflow_internal_flows_only: Whether to limit analysis to traffic that has both source and destination served by the same host.
-        :param pulumi.Input[int] netflow_observation_domain_id: The observation Domain ID for the netflow collector.
-        :param pulumi.Input[int] netflow_sampling_rate: The ratio of total number of packets to the number of packets analyzed. Set to 0 to disable sampling, meaning that all
-               packets are analyzed.
-        :param pulumi.Input[bool] network_resource_control_enabled: Whether or not to enable network resource control, enabling advanced traffic shaping and resource control features.
-        :param pulumi.Input[str] network_resource_control_version: The network I/O control version to use. Can be one of version2 or version3.
+        :param pulumi.Input[int] netflow_active_flow_timeout: The number of seconds after which
+               active flows are forced to be exported to the collector. Allowed range is
+               `60` to `3600`. Default: `60`.
+        :param pulumi.Input[str] netflow_collector_ip_address: IP address for the Netflow
+               collector, using IPv4 or IPv6. IPv6 is supported in VDS version 6.0 or later.
+               Must be set before Netflow can be enabled.
+        :param pulumi.Input[int] netflow_collector_port: Port for the Netflow collector. This
+               must be set before Netflow can be enabled.
+        :param pulumi.Input[bool] netflow_enabled: Enables Netflow on all ports that this policy
+               applies to.
+        :param pulumi.Input[int] netflow_idle_flow_timeout: The number of seconds after which
+               idle flows are forced to be exported to the collector. Allowed range is `10`
+               to `600`. Default: `15`.
+        :param pulumi.Input[bool] netflow_internal_flows_only: Whether to limit analysis to
+               traffic that has both source and destination served by the same host.
+               Default: `false`.
+        :param pulumi.Input[int] netflow_observation_domain_id: The observation domain ID for
+               the Netflow collector.
+        :param pulumi.Input[int] netflow_sampling_rate: The ratio of total number of packets to
+               the number of packets analyzed. The default is `0`, which indicates that the
+               VDS should analyze all packets. The maximum value is `1000`, which
+               indicates an analysis rate of 0.001%!
+               (MISSING)
+        :param pulumi.Input[bool] network_resource_control_enabled: Set to `true` to enable
+               network I/O control. Default: `false`.
+        :param pulumi.Input[str] network_resource_control_version: The version of network I/O
+               control to use. Can be one of `version2` or `version3`. Default: `version2`.
         :param pulumi.Input[int] nfs_maximum_mbit: The maximum allowed usage for the nfs traffic class, in Mbits/sec.
         :param pulumi.Input[int] nfs_reservation_mbit: The amount of guaranteed bandwidth for the nfs traffic class, in Mbits/sec.
         :param pulumi.Input[int] nfs_share_count: The amount of shares to allocate to the nfs traffic class for a custom share level.
         :param pulumi.Input[str] nfs_share_level: The allocation level for the nfs traffic class. Can be one of high, low, normal, or custom.
-        :param pulumi.Input[bool] notify_switches: If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
-        :param pulumi.Input[int] port_private_secondary_vlan_id: The secondary VLAN ID for this port.
-        :param pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchPvlanMappingArgs']]] pvlan_mappings: A private VLAN (PVLAN) mapping.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_uplinks: List of standby uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
+        :param pulumi.Input[bool] notify_switches: If `true`, the teaming policy will notify the
+               broadcast network of an uplink failover, triggering cache updates.
+        :param pulumi.Input[int] port_private_secondary_vlan_id: Used to define a secondary VLAN
+               ID when using private VLANs.
+        :param pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchPvlanMappingArgs']]] pvlan_mappings: Use the `pvlan_mapping` block to declare a
+               private VLAN mapping. The options are:
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_uplinks: A list of standby uplinks to be used in
+               failover. These uplinks need to match the definitions in the
+               `uplinks` VDS argument. See
+               here for more details.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource.
                
                > **NOTE:** Tagging support requires vCenter Server 6.0 or higher.
-        :param pulumi.Input[str] teaming_policy: The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid,
-               failover_explicit, or loadbalance_loadbased.
-        :param pulumi.Input[bool] tx_uplink: If true, a copy of packets sent to the switch will always be forwarded to an uplink in addition to the regular packet
-               forwarded done by the switch.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] uplinks: A list of uplink ports. The contents of this list control both the uplink count and names of the uplinks on the DVS
-               across hosts.
+        :param pulumi.Input[str] teaming_policy: The uplink teaming policy. Can be one of
+               `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`,
+               `failover_explicit`, or `loadbalance_loadbased`.
+        :param pulumi.Input[bool] tx_uplink: Forward all traffic transmitted by ports for which
+               this policy applies to its VDS uplinks.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] uplinks: A list of strings that uniquely identifies the names
+               of the uplinks on the VDS across hosts. The number of items in this list
+               controls the number of uplinks that exist on the VDS, in addition to the
+               names. See here for an example on how to
+               use this option.
         :param pulumi.Input[int] vdp_maximum_mbit: The maximum allowed usage for the vdp traffic class, in Mbits/sec.
         :param pulumi.Input[int] vdp_reservation_mbit: The amount of guaranteed bandwidth for the vdp traffic class, in Mbits/sec.
         :param pulumi.Input[int] vdp_share_count: The amount of shares to allocate to the vdp traffic class for a custom share level.
@@ -1783,7 +1975,28 @@ class _DistributedVirtualSwitchState:
         :param pulumi.Input[int] virtualmachine_share_count: The amount of shares to allocate to the virtualMachine traffic class for a custom share level.
         :param pulumi.Input[str] virtualmachine_share_level: The allocation level for the virtualMachine traffic class. Can be one of high, low, normal, or custom.
         :param pulumi.Input[int] vlan_id: The VLAN ID for single VLAN mode. 0 denotes no VLAN.
-        :param pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchVlanRangeArgs']]] vlan_ranges: The VLAN ID for single VLAN mode. 0 denotes no VLAN.
+        :param pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchVlanRangeArgs']]] vlan_ranges: Used to denote VLAN trunking. Use the `min_vlan`
+               and `max_vlan` sub-arguments to define the tagged VLAN range. Multiple
+               `vlan_range` definitions are allowed, but they must not overlap. Example
+               below:
+               
+               <!--Start PulumiCodeChooser -->
+               ```python
+               import pulumi
+               import pulumi_vsphere as vsphere
+               
+               vds = vsphere.DistributedVirtualSwitch("vds", vlan_ranges=[
+                   vsphere.DistributedVirtualSwitchVlanRangeArgs(
+                       max_vlan=199,
+                       min_vlan=100,
+                   ),
+                   vsphere.DistributedVirtualSwitchVlanRangeArgs(
+                       max_vlan=399,
+                       min_vlan=300,
+                   ),
+               ])
+               ```
+               <!--End PulumiCodeChooser -->
         :param pulumi.Input[int] vmotion_maximum_mbit: The maximum allowed usage for the vmotion traffic class, in Mbits/sec.
         :param pulumi.Input[int] vmotion_reservation_mbit: The amount of guaranteed bandwidth for the vmotion traffic class, in Mbits/sec.
         :param pulumi.Input[int] vmotion_share_count: The amount of shares to allocate to the vmotion traffic class for a custom share level.
@@ -1988,7 +2201,10 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="activeUplinks")
     def active_uplinks(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
-        List of active uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
+        A list of active uplinks to be used in load
+        balancing. These uplinks need to match the definitions in the
+        `uplinks` VDS argument. See
+        here for more details.
         """
         return pulumi.get(self, "active_uplinks")
 
@@ -2000,8 +2216,9 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="allowForgedTransmits")
     def allow_forged_transmits(self) -> Optional[pulumi.Input[bool]]:
         """
-        Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than
-        that of its own.
+        Controls whether or not a virtual
+        network adapter is allowed to send network traffic with a different MAC
+        address than that of its own.
         """
         return pulumi.get(self, "allow_forged_transmits")
 
@@ -2013,7 +2230,8 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="allowMacChanges")
     def allow_mac_changes(self) -> Optional[pulumi.Input[bool]]:
         """
-        Controls whether or not the Media Access Control (MAC) address can be changed.
+        Controls whether or not the Media Access
+        Control (MAC) address can be changed.
         """
         return pulumi.get(self, "allow_mac_changes")
 
@@ -2025,7 +2243,8 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="allowPromiscuous")
     def allow_promiscuous(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
+        Enable promiscuous mode on the network. This
+        flag indicates whether or not all traffic is seen on a given port.
         """
         return pulumi.get(self, "allow_promiscuous")
 
@@ -2085,7 +2304,9 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="blockAllPorts")
     def block_all_ports(self) -> Optional[pulumi.Input[bool]]:
         """
-        Indicates whether to block all ports by default.
+        Shuts down all ports in the port groups that
+        this policy applies to, effectively blocking all network access to connected
+        virtual devices.
         """
         return pulumi.get(self, "block_all_ports")
 
@@ -2097,7 +2318,11 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="checkBeacon")
     def check_beacon(self) -> Optional[pulumi.Input[bool]]:
         """
-        Enable beacon probing on the ports this policy applies to.
+        Enables beacon probing as an additional measure
+        to detect NIC failure.
+
+        > **NOTE:** VMware recommends using a minimum of 3 NICs when using beacon
+        probing.
         """
         return pulumi.get(self, "check_beacon")
 
@@ -2189,7 +2414,8 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="directpathGen2Allowed")
     def directpath_gen2_allowed(self) -> Optional[pulumi.Input[bool]]:
         """
-        Allow VMDirectPath Gen2 on the ports this policy applies to.
+        Allow VMDirectPath Gen2 for the ports
+        for which this policy applies to.
         """
         return pulumi.get(self, "directpath_gen2_allowed")
 
@@ -2201,7 +2427,8 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="egressShapingAverageBandwidth")
     def egress_shaping_average_bandwidth(self) -> Optional[pulumi.Input[int]]:
         """
-        The average egress bandwidth in bits per second if egress shaping is enabled on the port.
+        The average bandwidth in bits
+        per second if egress traffic shaping is enabled on the port.
         """
         return pulumi.get(self, "egress_shaping_average_bandwidth")
 
@@ -2213,7 +2440,8 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="egressShapingBurstSize")
     def egress_shaping_burst_size(self) -> Optional[pulumi.Input[int]]:
         """
-        The maximum egress burst size allowed in bytes if egress shaping is enabled on the port.
+        The maximum burst size allowed in
+        bytes if egress traffic shaping is enabled on the port.
         """
         return pulumi.get(self, "egress_shaping_burst_size")
 
@@ -2225,7 +2453,8 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="egressShapingEnabled")
     def egress_shaping_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        True if the traffic shaper is enabled for egress traffic on the port.
+        `true` if the traffic shaper is enabled
+        on the port for egress traffic.
         """
         return pulumi.get(self, "egress_shaping_enabled")
 
@@ -2237,7 +2466,8 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="egressShapingPeakBandwidth")
     def egress_shaping_peak_bandwidth(self) -> Optional[pulumi.Input[int]]:
         """
-        The peak egress bandwidth during bursts in bits per second if egress traffic shaping is enabled on the port.
+        The peak bandwidth during bursts
+        in bits per second if egress traffic shaping is enabled on the port.
         """
         return pulumi.get(self, "egress_shaping_peak_bandwidth")
 
@@ -2249,7 +2479,8 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter
     def failback(self) -> Optional[pulumi.Input[bool]]:
         """
-        If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
+        If `true`, the teaming policy will re-activate failed
+        uplinks higher in precedence when they come back up.
         """
         return pulumi.get(self, "failback")
 
@@ -2370,7 +2601,8 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter
     def hosts(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchHostArgs']]]]:
         """
-        A host member specification.
+        Use the `host` block to declare a host specification. The
+        options are:
         """
         return pulumi.get(self, "hosts")
 
@@ -2382,7 +2614,8 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="ignoreOtherPvlanMappings")
     def ignore_other_pvlan_mappings(self) -> Optional[pulumi.Input[bool]]:
         """
-        Whether to ignore existing PVLAN mappings not managed by this resource. Defaults to false.
+        Whether to ignore existing PVLAN
+        mappings not managed by this resource. Defaults to false.
         """
         return pulumi.get(self, "ignore_other_pvlan_mappings")
 
@@ -2394,7 +2627,8 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="ingressShapingAverageBandwidth")
     def ingress_shaping_average_bandwidth(self) -> Optional[pulumi.Input[int]]:
         """
-        The average ingress bandwidth in bits per second if ingress shaping is enabled on the port.
+        The average bandwidth in
+        bits per second if ingress traffic shaping is enabled on the port.
         """
         return pulumi.get(self, "ingress_shaping_average_bandwidth")
 
@@ -2406,7 +2640,8 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="ingressShapingBurstSize")
     def ingress_shaping_burst_size(self) -> Optional[pulumi.Input[int]]:
         """
-        The maximum ingress burst size allowed in bytes if ingress shaping is enabled on the port.
+        The maximum burst size allowed in
+        bytes if ingress traffic shaping is enabled on the port.
         """
         return pulumi.get(self, "ingress_shaping_burst_size")
 
@@ -2418,7 +2653,8 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="ingressShapingEnabled")
     def ingress_shaping_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        True if the traffic shaper is enabled for ingress traffic on the port.
+        `true` if the traffic shaper is
+        enabled on the port for ingress traffic.
         """
         return pulumi.get(self, "ingress_shaping_enabled")
 
@@ -2430,7 +2666,8 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="ingressShapingPeakBandwidth")
     def ingress_shaping_peak_bandwidth(self) -> Optional[pulumi.Input[int]]:
         """
-        The peak ingress bandwidth during bursts in bits per second if ingress traffic shaping is enabled on the port.
+        The peak bandwidth during
+        bursts in bits per second if ingress traffic shaping is enabled on the port.
         """
         return pulumi.get(self, "ingress_shaping_peak_bandwidth")
 
@@ -2517,7 +2754,8 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="lacpEnabled")
     def lacp_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        Whether or not to enable LACP on all uplink ports.
+        Enables LACP for the ports that this policy
+        applies to.
         """
         return pulumi.get(self, "lacp_enabled")
 
@@ -2529,7 +2767,7 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="lacpMode")
     def lacp_mode(self) -> Optional[pulumi.Input[str]]:
         """
-        The uplink LACP mode to use. Can be one of active or passive.
+        The LACP mode. Can be one of `active` or `passive`.
         """
         return pulumi.get(self, "lacp_mode")
 
@@ -2652,7 +2890,9 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="netflowActiveFlowTimeout")
     def netflow_active_flow_timeout(self) -> Optional[pulumi.Input[int]]:
         """
-        The number of seconds after which active flows are forced to be exported to the collector.
+        The number of seconds after which
+        active flows are forced to be exported to the collector. Allowed range is
+        `60` to `3600`. Default: `60`.
         """
         return pulumi.get(self, "netflow_active_flow_timeout")
 
@@ -2664,8 +2904,9 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="netflowCollectorIpAddress")
     def netflow_collector_ip_address(self) -> Optional[pulumi.Input[str]]:
         """
-        IP address for the netflow collector, using IPv4 or IPv6. IPv6 is supported in vSphere Distributed Switch Version 6.0 or
-        later.
+        IP address for the Netflow
+        collector, using IPv4 or IPv6. IPv6 is supported in VDS version 6.0 or later.
+        Must be set before Netflow can be enabled.
         """
         return pulumi.get(self, "netflow_collector_ip_address")
 
@@ -2677,7 +2918,8 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="netflowCollectorPort")
     def netflow_collector_port(self) -> Optional[pulumi.Input[int]]:
         """
-        The port for the netflow collector.
+        Port for the Netflow collector. This
+        must be set before Netflow can be enabled.
         """
         return pulumi.get(self, "netflow_collector_port")
 
@@ -2689,7 +2931,8 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="netflowEnabled")
     def netflow_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        Indicates whether to enable netflow on all ports.
+        Enables Netflow on all ports that this policy
+        applies to.
         """
         return pulumi.get(self, "netflow_enabled")
 
@@ -2701,7 +2944,9 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="netflowIdleFlowTimeout")
     def netflow_idle_flow_timeout(self) -> Optional[pulumi.Input[int]]:
         """
-        The number of seconds after which idle flows are forced to be exported to the collector.
+        The number of seconds after which
+        idle flows are forced to be exported to the collector. Allowed range is `10`
+        to `600`. Default: `15`.
         """
         return pulumi.get(self, "netflow_idle_flow_timeout")
 
@@ -2713,7 +2958,9 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="netflowInternalFlowsOnly")
     def netflow_internal_flows_only(self) -> Optional[pulumi.Input[bool]]:
         """
-        Whether to limit analysis to traffic that has both source and destination served by the same host.
+        Whether to limit analysis to
+        traffic that has both source and destination served by the same host.
+        Default: `false`.
         """
         return pulumi.get(self, "netflow_internal_flows_only")
 
@@ -2725,7 +2972,8 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="netflowObservationDomainId")
     def netflow_observation_domain_id(self) -> Optional[pulumi.Input[int]]:
         """
-        The observation Domain ID for the netflow collector.
+        The observation domain ID for
+        the Netflow collector.
         """
         return pulumi.get(self, "netflow_observation_domain_id")
 
@@ -2737,8 +2985,11 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="netflowSamplingRate")
     def netflow_sampling_rate(self) -> Optional[pulumi.Input[int]]:
         """
-        The ratio of total number of packets to the number of packets analyzed. Set to 0 to disable sampling, meaning that all
-        packets are analyzed.
+        The ratio of total number of packets to
+        the number of packets analyzed. The default is `0`, which indicates that the
+        VDS should analyze all packets. The maximum value is `1000`, which
+        indicates an analysis rate of 0.001%!
+        (MISSING)
         """
         return pulumi.get(self, "netflow_sampling_rate")
 
@@ -2750,7 +3001,8 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="networkResourceControlEnabled")
     def network_resource_control_enabled(self) -> Optional[pulumi.Input[bool]]:
         """
-        Whether or not to enable network resource control, enabling advanced traffic shaping and resource control features.
+        Set to `true` to enable
+        network I/O control. Default: `false`.
         """
         return pulumi.get(self, "network_resource_control_enabled")
 
@@ -2762,7 +3014,8 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="networkResourceControlVersion")
     def network_resource_control_version(self) -> Optional[pulumi.Input[str]]:
         """
-        The network I/O control version to use. Can be one of version2 or version3.
+        The version of network I/O
+        control to use. Can be one of `version2` or `version3`. Default: `version2`.
         """
         return pulumi.get(self, "network_resource_control_version")
 
@@ -2822,7 +3075,8 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="notifySwitches")
     def notify_switches(self) -> Optional[pulumi.Input[bool]]:
         """
-        If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
+        If `true`, the teaming policy will notify the
+        broadcast network of an uplink failover, triggering cache updates.
         """
         return pulumi.get(self, "notify_switches")
 
@@ -2834,7 +3088,8 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="portPrivateSecondaryVlanId")
     def port_private_secondary_vlan_id(self) -> Optional[pulumi.Input[int]]:
         """
-        The secondary VLAN ID for this port.
+        Used to define a secondary VLAN
+        ID when using private VLANs.
         """
         return pulumi.get(self, "port_private_secondary_vlan_id")
 
@@ -2846,7 +3101,8 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="pvlanMappings")
     def pvlan_mappings(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchPvlanMappingArgs']]]]:
         """
-        A private VLAN (PVLAN) mapping.
+        Use the `pvlan_mapping` block to declare a
+        private VLAN mapping. The options are:
         """
         return pulumi.get(self, "pvlan_mappings")
 
@@ -2858,7 +3114,10 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="standbyUplinks")
     def standby_uplinks(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
-        List of standby uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
+        A list of standby uplinks to be used in
+        failover. These uplinks need to match the definitions in the
+        `uplinks` VDS argument. See
+        here for more details.
         """
         return pulumi.get(self, "standby_uplinks")
 
@@ -2884,8 +3143,9 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="teamingPolicy")
     def teaming_policy(self) -> Optional[pulumi.Input[str]]:
         """
-        The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid,
-        failover_explicit, or loadbalance_loadbased.
+        The uplink teaming policy. Can be one of
+        `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`,
+        `failover_explicit`, or `loadbalance_loadbased`.
         """
         return pulumi.get(self, "teaming_policy")
 
@@ -2897,8 +3157,8 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="txUplink")
     def tx_uplink(self) -> Optional[pulumi.Input[bool]]:
         """
-        If true, a copy of packets sent to the switch will always be forwarded to an uplink in addition to the regular packet
-        forwarded done by the switch.
+        Forward all traffic transmitted by ports for which
+        this policy applies to its VDS uplinks.
         """
         return pulumi.get(self, "tx_uplink")
 
@@ -2910,8 +3170,11 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter
     def uplinks(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
-        A list of uplink ports. The contents of this list control both the uplink count and names of the uplinks on the DVS
-        across hosts.
+        A list of strings that uniquely identifies the names
+        of the uplinks on the VDS across hosts. The number of items in this list
+        controls the number of uplinks that exist on the VDS, in addition to the
+        names. See here for an example on how to
+        use this option.
         """
         return pulumi.get(self, "uplinks")
 
@@ -3045,7 +3308,28 @@ class _DistributedVirtualSwitchState:
     @pulumi.getter(name="vlanRanges")
     def vlan_ranges(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['DistributedVirtualSwitchVlanRangeArgs']]]]:
         """
-        The VLAN ID for single VLAN mode. 0 denotes no VLAN.
+        Used to denote VLAN trunking. Use the `min_vlan`
+        and `max_vlan` sub-arguments to define the tagged VLAN range. Multiple
+        `vlan_range` definitions are allowed, but they must not overlap. Example
+        below:
+
+        <!--Start PulumiCodeChooser -->
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+
+        vds = vsphere.DistributedVirtualSwitch("vds", vlan_ranges=[
+            vsphere.DistributedVirtualSwitchVlanRangeArgs(
+                max_vlan=199,
+                min_vlan=100,
+            ),
+            vsphere.DistributedVirtualSwitchVlanRangeArgs(
+                max_vlan=399,
+                min_vlan=300,
+            ),
+        ])
+        ```
+        <!--End PulumiCodeChooser -->
         """
         return pulumi.get(self, "vlan_ranges")
 
@@ -3254,17 +3538,29 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
         Create a DistributedVirtualSwitch resource with the given unique name, props, and options.
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] active_uplinks: List of active uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
-        :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than
-               that of its own.
-        :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access Control (MAC) address can be changed.
-        :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] active_uplinks: A list of active uplinks to be used in load
+               balancing. These uplinks need to match the definitions in the
+               `uplinks` VDS argument. See
+               here for more details.
+        :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not a virtual
+               network adapter is allowed to send network traffic with a different MAC
+               address than that of its own.
+        :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access
+               Control (MAC) address can be changed.
+        :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This
+               flag indicates whether or not all traffic is seen on a given port.
         :param pulumi.Input[int] backupnfc_maximum_mbit: The maximum allowed usage for the backupNfc traffic class, in Mbits/sec.
         :param pulumi.Input[int] backupnfc_reservation_mbit: The amount of guaranteed bandwidth for the backupNfc traffic class, in Mbits/sec.
         :param pulumi.Input[int] backupnfc_share_count: The amount of shares to allocate to the backupNfc traffic class for a custom share level.
         :param pulumi.Input[str] backupnfc_share_level: The allocation level for the backupNfc traffic class. Can be one of high, low, normal, or custom.
-        :param pulumi.Input[bool] block_all_ports: Indicates whether to block all ports by default.
-        :param pulumi.Input[bool] check_beacon: Enable beacon probing on the ports this policy applies to.
+        :param pulumi.Input[bool] block_all_ports: Shuts down all ports in the port groups that
+               this policy applies to, effectively blocking all network access to connected
+               virtual devices.
+        :param pulumi.Input[bool] check_beacon: Enables beacon probing as an additional measure
+               to detect NIC failure.
+               
+               > **NOTE:** VMware recommends using a minimum of 3 NICs when using beacon
+               probing.
         :param pulumi.Input[str] contact_detail: The detailed contact information for the person
                who is responsible for the VDS.
         :param pulumi.Input[str] contact_name: The name of the person who is responsible for the
@@ -3277,12 +3573,18 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
         :param pulumi.Input[str] datacenter_id: The ID of the datacenter where the VDS will be
                created. Forces a new resource if changed.
         :param pulumi.Input[str] description: A detailed description for the VDS.
-        :param pulumi.Input[bool] directpath_gen2_allowed: Allow VMDirectPath Gen2 on the ports this policy applies to.
-        :param pulumi.Input[int] egress_shaping_average_bandwidth: The average egress bandwidth in bits per second if egress shaping is enabled on the port.
-        :param pulumi.Input[int] egress_shaping_burst_size: The maximum egress burst size allowed in bytes if egress shaping is enabled on the port.
-        :param pulumi.Input[bool] egress_shaping_enabled: True if the traffic shaper is enabled for egress traffic on the port.
-        :param pulumi.Input[int] egress_shaping_peak_bandwidth: The peak egress bandwidth during bursts in bits per second if egress traffic shaping is enabled on the port.
-        :param pulumi.Input[bool] failback: If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
+        :param pulumi.Input[bool] directpath_gen2_allowed: Allow VMDirectPath Gen2 for the ports
+               for which this policy applies to.
+        :param pulumi.Input[int] egress_shaping_average_bandwidth: The average bandwidth in bits
+               per second if egress traffic shaping is enabled on the port.
+        :param pulumi.Input[int] egress_shaping_burst_size: The maximum burst size allowed in
+               bytes if egress traffic shaping is enabled on the port.
+        :param pulumi.Input[bool] egress_shaping_enabled: `true` if the traffic shaper is enabled
+               on the port for egress traffic.
+        :param pulumi.Input[int] egress_shaping_peak_bandwidth: The peak bandwidth during bursts
+               in bits per second if egress traffic shaping is enabled on the port.
+        :param pulumi.Input[bool] failback: If `true`, the teaming policy will re-activate failed
+               uplinks higher in precedence when they come back up.
         :param pulumi.Input[int] faulttolerance_maximum_mbit: The maximum allowed usage for the faultTolerance traffic class, in Mbits/sec.
         :param pulumi.Input[int] faulttolerance_reservation_mbit: The amount of guaranteed bandwidth for the faultTolerance traffic class, in Mbits/sec.
         :param pulumi.Input[int] faulttolerance_share_count: The amount of shares to allocate to the faultTolerance traffic class for a custom share level.
@@ -3293,12 +3595,18 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
         :param pulumi.Input[int] hbr_reservation_mbit: The amount of guaranteed bandwidth for the hbr traffic class, in Mbits/sec.
         :param pulumi.Input[int] hbr_share_count: The amount of shares to allocate to the hbr traffic class for a custom share level.
         :param pulumi.Input[str] hbr_share_level: The allocation level for the hbr traffic class. Can be one of high, low, normal, or custom.
-        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchHostArgs']]]] hosts: A host member specification.
-        :param pulumi.Input[bool] ignore_other_pvlan_mappings: Whether to ignore existing PVLAN mappings not managed by this resource. Defaults to false.
-        :param pulumi.Input[int] ingress_shaping_average_bandwidth: The average ingress bandwidth in bits per second if ingress shaping is enabled on the port.
-        :param pulumi.Input[int] ingress_shaping_burst_size: The maximum ingress burst size allowed in bytes if ingress shaping is enabled on the port.
-        :param pulumi.Input[bool] ingress_shaping_enabled: True if the traffic shaper is enabled for ingress traffic on the port.
-        :param pulumi.Input[int] ingress_shaping_peak_bandwidth: The peak ingress bandwidth during bursts in bits per second if ingress traffic shaping is enabled on the port.
+        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchHostArgs']]]] hosts: Use the `host` block to declare a host specification. The
+               options are:
+        :param pulumi.Input[bool] ignore_other_pvlan_mappings: Whether to ignore existing PVLAN
+               mappings not managed by this resource. Defaults to false.
+        :param pulumi.Input[int] ingress_shaping_average_bandwidth: The average bandwidth in
+               bits per second if ingress traffic shaping is enabled on the port.
+        :param pulumi.Input[int] ingress_shaping_burst_size: The maximum burst size allowed in
+               bytes if ingress traffic shaping is enabled on the port.
+        :param pulumi.Input[bool] ingress_shaping_enabled: `true` if the traffic shaper is
+               enabled on the port for ingress traffic.
+        :param pulumi.Input[int] ingress_shaping_peak_bandwidth: The peak bandwidth during
+               bursts in bits per second if ingress traffic shaping is enabled on the port.
         :param pulumi.Input[str] ipv4_address: An IPv4 address to identify the switch. This is
                mostly useful when used with the Netflow arguments.
         :param pulumi.Input[int] iscsi_maximum_mbit: The maximum allowed usage for the iSCSI traffic class, in Mbits/sec.
@@ -3308,8 +3616,9 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
         :param pulumi.Input[str] lacp_api_version: The Link Aggregation Control Protocol group
                version to use with the VDS. Possible values are `singleLag` and
                `multipleLag`.
-        :param pulumi.Input[bool] lacp_enabled: Whether or not to enable LACP on all uplink ports.
-        :param pulumi.Input[str] lacp_mode: The uplink LACP mode to use. Can be one of active or passive.
+        :param pulumi.Input[bool] lacp_enabled: Enables LACP for the ports that this policy
+               applies to.
+        :param pulumi.Input[str] lacp_mode: The LACP mode. Can be one of `active` or `passive`.
         :param pulumi.Input[str] link_discovery_operation: Whether to `advertise` or `listen`
                for link discovery traffic.
         :param pulumi.Input[str] link_discovery_protocol: The discovery protocol type. Valid
@@ -3322,35 +3631,60 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
         :param pulumi.Input[str] multicast_filtering_mode: The multicast filtering mode to use
                with the VDS. Can be one of `legacyFiltering` or `snooping`.
         :param pulumi.Input[str] name: The name of the VDS.
-        :param pulumi.Input[int] netflow_active_flow_timeout: The number of seconds after which active flows are forced to be exported to the collector.
-        :param pulumi.Input[str] netflow_collector_ip_address: IP address for the netflow collector, using IPv4 or IPv6. IPv6 is supported in vSphere Distributed Switch Version 6.0 or
-               later.
-        :param pulumi.Input[int] netflow_collector_port: The port for the netflow collector.
-        :param pulumi.Input[bool] netflow_enabled: Indicates whether to enable netflow on all ports.
-        :param pulumi.Input[int] netflow_idle_flow_timeout: The number of seconds after which idle flows are forced to be exported to the collector.
-        :param pulumi.Input[bool] netflow_internal_flows_only: Whether to limit analysis to traffic that has both source and destination served by the same host.
-        :param pulumi.Input[int] netflow_observation_domain_id: The observation Domain ID for the netflow collector.
-        :param pulumi.Input[int] netflow_sampling_rate: The ratio of total number of packets to the number of packets analyzed. Set to 0 to disable sampling, meaning that all
-               packets are analyzed.
-        :param pulumi.Input[bool] network_resource_control_enabled: Whether or not to enable network resource control, enabling advanced traffic shaping and resource control features.
-        :param pulumi.Input[str] network_resource_control_version: The network I/O control version to use. Can be one of version2 or version3.
+        :param pulumi.Input[int] netflow_active_flow_timeout: The number of seconds after which
+               active flows are forced to be exported to the collector. Allowed range is
+               `60` to `3600`. Default: `60`.
+        :param pulumi.Input[str] netflow_collector_ip_address: IP address for the Netflow
+               collector, using IPv4 or IPv6. IPv6 is supported in VDS version 6.0 or later.
+               Must be set before Netflow can be enabled.
+        :param pulumi.Input[int] netflow_collector_port: Port for the Netflow collector. This
+               must be set before Netflow can be enabled.
+        :param pulumi.Input[bool] netflow_enabled: Enables Netflow on all ports that this policy
+               applies to.
+        :param pulumi.Input[int] netflow_idle_flow_timeout: The number of seconds after which
+               idle flows are forced to be exported to the collector. Allowed range is `10`
+               to `600`. Default: `15`.
+        :param pulumi.Input[bool] netflow_internal_flows_only: Whether to limit analysis to
+               traffic that has both source and destination served by the same host.
+               Default: `false`.
+        :param pulumi.Input[int] netflow_observation_domain_id: The observation domain ID for
+               the Netflow collector.
+        :param pulumi.Input[int] netflow_sampling_rate: The ratio of total number of packets to
+               the number of packets analyzed. The default is `0`, which indicates that the
+               VDS should analyze all packets. The maximum value is `1000`, which
+               indicates an analysis rate of 0.001%!
+               (MISSING)
+        :param pulumi.Input[bool] network_resource_control_enabled: Set to `true` to enable
+               network I/O control. Default: `false`.
+        :param pulumi.Input[str] network_resource_control_version: The version of network I/O
+               control to use. Can be one of `version2` or `version3`. Default: `version2`.
         :param pulumi.Input[int] nfs_maximum_mbit: The maximum allowed usage for the nfs traffic class, in Mbits/sec.
         :param pulumi.Input[int] nfs_reservation_mbit: The amount of guaranteed bandwidth for the nfs traffic class, in Mbits/sec.
         :param pulumi.Input[int] nfs_share_count: The amount of shares to allocate to the nfs traffic class for a custom share level.
         :param pulumi.Input[str] nfs_share_level: The allocation level for the nfs traffic class. Can be one of high, low, normal, or custom.
-        :param pulumi.Input[bool] notify_switches: If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
-        :param pulumi.Input[int] port_private_secondary_vlan_id: The secondary VLAN ID for this port.
-        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchPvlanMappingArgs']]]] pvlan_mappings: A private VLAN (PVLAN) mapping.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_uplinks: List of standby uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
+        :param pulumi.Input[bool] notify_switches: If `true`, the teaming policy will notify the
+               broadcast network of an uplink failover, triggering cache updates.
+        :param pulumi.Input[int] port_private_secondary_vlan_id: Used to define a secondary VLAN
+               ID when using private VLANs.
+        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchPvlanMappingArgs']]]] pvlan_mappings: Use the `pvlan_mapping` block to declare a
+               private VLAN mapping. The options are:
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_uplinks: A list of standby uplinks to be used in
+               failover. These uplinks need to match the definitions in the
+               `uplinks` VDS argument. See
+               here for more details.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource.
                
                > **NOTE:** Tagging support requires vCenter Server 6.0 or higher.
-        :param pulumi.Input[str] teaming_policy: The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid,
-               failover_explicit, or loadbalance_loadbased.
-        :param pulumi.Input[bool] tx_uplink: If true, a copy of packets sent to the switch will always be forwarded to an uplink in addition to the regular packet
-               forwarded done by the switch.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] uplinks: A list of uplink ports. The contents of this list control both the uplink count and names of the uplinks on the DVS
-               across hosts.
+        :param pulumi.Input[str] teaming_policy: The uplink teaming policy. Can be one of
+               `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`,
+               `failover_explicit`, or `loadbalance_loadbased`.
+        :param pulumi.Input[bool] tx_uplink: Forward all traffic transmitted by ports for which
+               this policy applies to its VDS uplinks.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] uplinks: A list of strings that uniquely identifies the names
+               of the uplinks on the VDS across hosts. The number of items in this list
+               controls the number of uplinks that exist on the VDS, in addition to the
+               names. See here for an example on how to
+               use this option.
         :param pulumi.Input[int] vdp_maximum_mbit: The maximum allowed usage for the vdp traffic class, in Mbits/sec.
         :param pulumi.Input[int] vdp_reservation_mbit: The amount of guaranteed bandwidth for the vdp traffic class, in Mbits/sec.
         :param pulumi.Input[int] vdp_share_count: The amount of shares to allocate to the vdp traffic class for a custom share level.
@@ -3363,7 +3697,28 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
         :param pulumi.Input[int] virtualmachine_share_count: The amount of shares to allocate to the virtualMachine traffic class for a custom share level.
         :param pulumi.Input[str] virtualmachine_share_level: The allocation level for the virtualMachine traffic class. Can be one of high, low, normal, or custom.
         :param pulumi.Input[int] vlan_id: The VLAN ID for single VLAN mode. 0 denotes no VLAN.
-        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchVlanRangeArgs']]]] vlan_ranges: The VLAN ID for single VLAN mode. 0 denotes no VLAN.
+        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchVlanRangeArgs']]]] vlan_ranges: Used to denote VLAN trunking. Use the `min_vlan`
+               and `max_vlan` sub-arguments to define the tagged VLAN range. Multiple
+               `vlan_range` definitions are allowed, but they must not overlap. Example
+               below:
+               
+               <!--Start PulumiCodeChooser -->
+               ```python
+               import pulumi
+               import pulumi_vsphere as vsphere
+               
+               vds = vsphere.DistributedVirtualSwitch("vds", vlan_ranges=[
+                   vsphere.DistributedVirtualSwitchVlanRangeArgs(
+                       max_vlan=199,
+                       min_vlan=100,
+                   ),
+                   vsphere.DistributedVirtualSwitchVlanRangeArgs(
+                       max_vlan=399,
+                       min_vlan=300,
+                   ),
+               ])
+               ```
+               <!--End PulumiCodeChooser -->
         :param pulumi.Input[int] vmotion_maximum_mbit: The maximum allowed usage for the vmotion traffic class, in Mbits/sec.
         :param pulumi.Input[int] vmotion_reservation_mbit: The amount of guaranteed bandwidth for the vmotion traffic class, in Mbits/sec.
         :param pulumi.Input[int] vmotion_share_count: The amount of shares to allocate to the vmotion traffic class for a custom share level.
@@ -3708,17 +4063,29 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
         :param str resource_name: The unique name of the resulting resource.
         :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] active_uplinks: List of active uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
-        :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than
-               that of its own.
-        :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access Control (MAC) address can be changed.
-        :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] active_uplinks: A list of active uplinks to be used in load
+               balancing. These uplinks need to match the definitions in the
+               `uplinks` VDS argument. See
+               here for more details.
+        :param pulumi.Input[bool] allow_forged_transmits: Controls whether or not a virtual
+               network adapter is allowed to send network traffic with a different MAC
+               address than that of its own.
+        :param pulumi.Input[bool] allow_mac_changes: Controls whether or not the Media Access
+               Control (MAC) address can be changed.
+        :param pulumi.Input[bool] allow_promiscuous: Enable promiscuous mode on the network. This
+               flag indicates whether or not all traffic is seen on a given port.
         :param pulumi.Input[int] backupnfc_maximum_mbit: The maximum allowed usage for the backupNfc traffic class, in Mbits/sec.
         :param pulumi.Input[int] backupnfc_reservation_mbit: The amount of guaranteed bandwidth for the backupNfc traffic class, in Mbits/sec.
         :param pulumi.Input[int] backupnfc_share_count: The amount of shares to allocate to the backupNfc traffic class for a custom share level.
         :param pulumi.Input[str] backupnfc_share_level: The allocation level for the backupNfc traffic class. Can be one of high, low, normal, or custom.
-        :param pulumi.Input[bool] block_all_ports: Indicates whether to block all ports by default.
-        :param pulumi.Input[bool] check_beacon: Enable beacon probing on the ports this policy applies to.
+        :param pulumi.Input[bool] block_all_ports: Shuts down all ports in the port groups that
+               this policy applies to, effectively blocking all network access to connected
+               virtual devices.
+        :param pulumi.Input[bool] check_beacon: Enables beacon probing as an additional measure
+               to detect NIC failure.
+               
+               > **NOTE:** VMware recommends using a minimum of 3 NICs when using beacon
+               probing.
         :param pulumi.Input[str] config_version: The current version of the VDS configuration, incremented
                by subsequent updates to the VDS.
         :param pulumi.Input[str] contact_detail: The detailed contact information for the person
@@ -3733,12 +4100,18 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
         :param pulumi.Input[str] datacenter_id: The ID of the datacenter where the VDS will be
                created. Forces a new resource if changed.
         :param pulumi.Input[str] description: A detailed description for the VDS.
-        :param pulumi.Input[bool] directpath_gen2_allowed: Allow VMDirectPath Gen2 on the ports this policy applies to.
-        :param pulumi.Input[int] egress_shaping_average_bandwidth: The average egress bandwidth in bits per second if egress shaping is enabled on the port.
-        :param pulumi.Input[int] egress_shaping_burst_size: The maximum egress burst size allowed in bytes if egress shaping is enabled on the port.
-        :param pulumi.Input[bool] egress_shaping_enabled: True if the traffic shaper is enabled for egress traffic on the port.
-        :param pulumi.Input[int] egress_shaping_peak_bandwidth: The peak egress bandwidth during bursts in bits per second if egress traffic shaping is enabled on the port.
-        :param pulumi.Input[bool] failback: If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
+        :param pulumi.Input[bool] directpath_gen2_allowed: Allow VMDirectPath Gen2 for the ports
+               for which this policy applies to.
+        :param pulumi.Input[int] egress_shaping_average_bandwidth: The average bandwidth in bits
+               per second if egress traffic shaping is enabled on the port.
+        :param pulumi.Input[int] egress_shaping_burst_size: The maximum burst size allowed in
+               bytes if egress traffic shaping is enabled on the port.
+        :param pulumi.Input[bool] egress_shaping_enabled: `true` if the traffic shaper is enabled
+               on the port for egress traffic.
+        :param pulumi.Input[int] egress_shaping_peak_bandwidth: The peak bandwidth during bursts
+               in bits per second if egress traffic shaping is enabled on the port.
+        :param pulumi.Input[bool] failback: If `true`, the teaming policy will re-activate failed
+               uplinks higher in precedence when they come back up.
         :param pulumi.Input[int] faulttolerance_maximum_mbit: The maximum allowed usage for the faultTolerance traffic class, in Mbits/sec.
         :param pulumi.Input[int] faulttolerance_reservation_mbit: The amount of guaranteed bandwidth for the faultTolerance traffic class, in Mbits/sec.
         :param pulumi.Input[int] faulttolerance_share_count: The amount of shares to allocate to the faultTolerance traffic class for a custom share level.
@@ -3749,12 +4122,18 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
         :param pulumi.Input[int] hbr_reservation_mbit: The amount of guaranteed bandwidth for the hbr traffic class, in Mbits/sec.
         :param pulumi.Input[int] hbr_share_count: The amount of shares to allocate to the hbr traffic class for a custom share level.
         :param pulumi.Input[str] hbr_share_level: The allocation level for the hbr traffic class. Can be one of high, low, normal, or custom.
-        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchHostArgs']]]] hosts: A host member specification.
-        :param pulumi.Input[bool] ignore_other_pvlan_mappings: Whether to ignore existing PVLAN mappings not managed by this resource. Defaults to false.
-        :param pulumi.Input[int] ingress_shaping_average_bandwidth: The average ingress bandwidth in bits per second if ingress shaping is enabled on the port.
-        :param pulumi.Input[int] ingress_shaping_burst_size: The maximum ingress burst size allowed in bytes if ingress shaping is enabled on the port.
-        :param pulumi.Input[bool] ingress_shaping_enabled: True if the traffic shaper is enabled for ingress traffic on the port.
-        :param pulumi.Input[int] ingress_shaping_peak_bandwidth: The peak ingress bandwidth during bursts in bits per second if ingress traffic shaping is enabled on the port.
+        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchHostArgs']]]] hosts: Use the `host` block to declare a host specification. The
+               options are:
+        :param pulumi.Input[bool] ignore_other_pvlan_mappings: Whether to ignore existing PVLAN
+               mappings not managed by this resource. Defaults to false.
+        :param pulumi.Input[int] ingress_shaping_average_bandwidth: The average bandwidth in
+               bits per second if ingress traffic shaping is enabled on the port.
+        :param pulumi.Input[int] ingress_shaping_burst_size: The maximum burst size allowed in
+               bytes if ingress traffic shaping is enabled on the port.
+        :param pulumi.Input[bool] ingress_shaping_enabled: `true` if the traffic shaper is
+               enabled on the port for ingress traffic.
+        :param pulumi.Input[int] ingress_shaping_peak_bandwidth: The peak bandwidth during
+               bursts in bits per second if ingress traffic shaping is enabled on the port.
         :param pulumi.Input[str] ipv4_address: An IPv4 address to identify the switch. This is
                mostly useful when used with the Netflow arguments.
         :param pulumi.Input[int] iscsi_maximum_mbit: The maximum allowed usage for the iSCSI traffic class, in Mbits/sec.
@@ -3764,8 +4143,9 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
         :param pulumi.Input[str] lacp_api_version: The Link Aggregation Control Protocol group
                version to use with the VDS. Possible values are `singleLag` and
                `multipleLag`.
-        :param pulumi.Input[bool] lacp_enabled: Whether or not to enable LACP on all uplink ports.
-        :param pulumi.Input[str] lacp_mode: The uplink LACP mode to use. Can be one of active or passive.
+        :param pulumi.Input[bool] lacp_enabled: Enables LACP for the ports that this policy
+               applies to.
+        :param pulumi.Input[str] lacp_mode: The LACP mode. Can be one of `active` or `passive`.
         :param pulumi.Input[str] link_discovery_operation: Whether to `advertise` or `listen`
                for link discovery traffic.
         :param pulumi.Input[str] link_discovery_protocol: The discovery protocol type. Valid
@@ -3778,35 +4158,60 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
         :param pulumi.Input[str] multicast_filtering_mode: The multicast filtering mode to use
                with the VDS. Can be one of `legacyFiltering` or `snooping`.
         :param pulumi.Input[str] name: The name of the VDS.
-        :param pulumi.Input[int] netflow_active_flow_timeout: The number of seconds after which active flows are forced to be exported to the collector.
-        :param pulumi.Input[str] netflow_collector_ip_address: IP address for the netflow collector, using IPv4 or IPv6. IPv6 is supported in vSphere Distributed Switch Version 6.0 or
-               later.
-        :param pulumi.Input[int] netflow_collector_port: The port for the netflow collector.
-        :param pulumi.Input[bool] netflow_enabled: Indicates whether to enable netflow on all ports.
-        :param pulumi.Input[int] netflow_idle_flow_timeout: The number of seconds after which idle flows are forced to be exported to the collector.
-        :param pulumi.Input[bool] netflow_internal_flows_only: Whether to limit analysis to traffic that has both source and destination served by the same host.
-        :param pulumi.Input[int] netflow_observation_domain_id: The observation Domain ID for the netflow collector.
-        :param pulumi.Input[int] netflow_sampling_rate: The ratio of total number of packets to the number of packets analyzed. Set to 0 to disable sampling, meaning that all
-               packets are analyzed.
-        :param pulumi.Input[bool] network_resource_control_enabled: Whether or not to enable network resource control, enabling advanced traffic shaping and resource control features.
-        :param pulumi.Input[str] network_resource_control_version: The network I/O control version to use. Can be one of version2 or version3.
+        :param pulumi.Input[int] netflow_active_flow_timeout: The number of seconds after which
+               active flows are forced to be exported to the collector. Allowed range is
+               `60` to `3600`. Default: `60`.
+        :param pulumi.Input[str] netflow_collector_ip_address: IP address for the Netflow
+               collector, using IPv4 or IPv6. IPv6 is supported in VDS version 6.0 or later.
+               Must be set before Netflow can be enabled.
+        :param pulumi.Input[int] netflow_collector_port: Port for the Netflow collector. This
+               must be set before Netflow can be enabled.
+        :param pulumi.Input[bool] netflow_enabled: Enables Netflow on all ports that this policy
+               applies to.
+        :param pulumi.Input[int] netflow_idle_flow_timeout: The number of seconds after which
+               idle flows are forced to be exported to the collector. Allowed range is `10`
+               to `600`. Default: `15`.
+        :param pulumi.Input[bool] netflow_internal_flows_only: Whether to limit analysis to
+               traffic that has both source and destination served by the same host.
+               Default: `false`.
+        :param pulumi.Input[int] netflow_observation_domain_id: The observation domain ID for
+               the Netflow collector.
+        :param pulumi.Input[int] netflow_sampling_rate: The ratio of total number of packets to
+               the number of packets analyzed. The default is `0`, which indicates that the
+               VDS should analyze all packets. The maximum value is `1000`, which
+               indicates an analysis rate of 0.001%!
+               (MISSING)
+        :param pulumi.Input[bool] network_resource_control_enabled: Set to `true` to enable
+               network I/O control. Default: `false`.
+        :param pulumi.Input[str] network_resource_control_version: The version of network I/O
+               control to use. Can be one of `version2` or `version3`. Default: `version2`.
         :param pulumi.Input[int] nfs_maximum_mbit: The maximum allowed usage for the nfs traffic class, in Mbits/sec.
         :param pulumi.Input[int] nfs_reservation_mbit: The amount of guaranteed bandwidth for the nfs traffic class, in Mbits/sec.
         :param pulumi.Input[int] nfs_share_count: The amount of shares to allocate to the nfs traffic class for a custom share level.
         :param pulumi.Input[str] nfs_share_level: The allocation level for the nfs traffic class. Can be one of high, low, normal, or custom.
-        :param pulumi.Input[bool] notify_switches: If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
-        :param pulumi.Input[int] port_private_secondary_vlan_id: The secondary VLAN ID for this port.
-        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchPvlanMappingArgs']]]] pvlan_mappings: A private VLAN (PVLAN) mapping.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_uplinks: List of standby uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
+        :param pulumi.Input[bool] notify_switches: If `true`, the teaming policy will notify the
+               broadcast network of an uplink failover, triggering cache updates.
+        :param pulumi.Input[int] port_private_secondary_vlan_id: Used to define a secondary VLAN
+               ID when using private VLANs.
+        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchPvlanMappingArgs']]]] pvlan_mappings: Use the `pvlan_mapping` block to declare a
+               private VLAN mapping. The options are:
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] standby_uplinks: A list of standby uplinks to be used in
+               failover. These uplinks need to match the definitions in the
+               `uplinks` VDS argument. See
+               here for more details.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] tags: The IDs of any tags to attach to this resource.
                
                > **NOTE:** Tagging support requires vCenter Server 6.0 or higher.
-        :param pulumi.Input[str] teaming_policy: The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid,
-               failover_explicit, or loadbalance_loadbased.
-        :param pulumi.Input[bool] tx_uplink: If true, a copy of packets sent to the switch will always be forwarded to an uplink in addition to the regular packet
-               forwarded done by the switch.
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] uplinks: A list of uplink ports. The contents of this list control both the uplink count and names of the uplinks on the DVS
-               across hosts.
+        :param pulumi.Input[str] teaming_policy: The uplink teaming policy. Can be one of
+               `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`,
+               `failover_explicit`, or `loadbalance_loadbased`.
+        :param pulumi.Input[bool] tx_uplink: Forward all traffic transmitted by ports for which
+               this policy applies to its VDS uplinks.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] uplinks: A list of strings that uniquely identifies the names
+               of the uplinks on the VDS across hosts. The number of items in this list
+               controls the number of uplinks that exist on the VDS, in addition to the
+               names. See here for an example on how to
+               use this option.
         :param pulumi.Input[int] vdp_maximum_mbit: The maximum allowed usage for the vdp traffic class, in Mbits/sec.
         :param pulumi.Input[int] vdp_reservation_mbit: The amount of guaranteed bandwidth for the vdp traffic class, in Mbits/sec.
         :param pulumi.Input[int] vdp_share_count: The amount of shares to allocate to the vdp traffic class for a custom share level.
@@ -3819,7 +4224,28 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
         :param pulumi.Input[int] virtualmachine_share_count: The amount of shares to allocate to the virtualMachine traffic class for a custom share level.
         :param pulumi.Input[str] virtualmachine_share_level: The allocation level for the virtualMachine traffic class. Can be one of high, low, normal, or custom.
         :param pulumi.Input[int] vlan_id: The VLAN ID for single VLAN mode. 0 denotes no VLAN.
-        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchVlanRangeArgs']]]] vlan_ranges: The VLAN ID for single VLAN mode. 0 denotes no VLAN.
+        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['DistributedVirtualSwitchVlanRangeArgs']]]] vlan_ranges: Used to denote VLAN trunking. Use the `min_vlan`
+               and `max_vlan` sub-arguments to define the tagged VLAN range. Multiple
+               `vlan_range` definitions are allowed, but they must not overlap. Example
+               below:
+               
+               <!--Start PulumiCodeChooser -->
+               ```python
+               import pulumi
+               import pulumi_vsphere as vsphere
+               
+               vds = vsphere.DistributedVirtualSwitch("vds", vlan_ranges=[
+                   vsphere.DistributedVirtualSwitchVlanRangeArgs(
+                       max_vlan=199,
+                       min_vlan=100,
+                   ),
+                   vsphere.DistributedVirtualSwitchVlanRangeArgs(
+                       max_vlan=399,
+                       min_vlan=300,
+                   ),
+               ])
+               ```
+               <!--End PulumiCodeChooser -->
         :param pulumi.Input[int] vmotion_maximum_mbit: The maximum allowed usage for the vmotion traffic class, in Mbits/sec.
         :param pulumi.Input[int] vmotion_reservation_mbit: The amount of guaranteed bandwidth for the vmotion traffic class, in Mbits/sec.
         :param pulumi.Input[int] vmotion_share_count: The amount of shares to allocate to the vmotion traffic class for a custom share level.
@@ -3934,7 +4360,10 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="activeUplinks")
     def active_uplinks(self) -> pulumi.Output[Sequence[str]]:
         """
-        List of active uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
+        A list of active uplinks to be used in load
+        balancing. These uplinks need to match the definitions in the
+        `uplinks` VDS argument. See
+        here for more details.
         """
         return pulumi.get(self, "active_uplinks")
 
@@ -3942,8 +4371,9 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="allowForgedTransmits")
     def allow_forged_transmits(self) -> pulumi.Output[bool]:
         """
-        Controls whether or not the virtual network adapter is allowed to send network traffic with a different MAC address than
-        that of its own.
+        Controls whether or not a virtual
+        network adapter is allowed to send network traffic with a different MAC
+        address than that of its own.
         """
         return pulumi.get(self, "allow_forged_transmits")
 
@@ -3951,7 +4381,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="allowMacChanges")
     def allow_mac_changes(self) -> pulumi.Output[bool]:
         """
-        Controls whether or not the Media Access Control (MAC) address can be changed.
+        Controls whether or not the Media Access
+        Control (MAC) address can be changed.
         """
         return pulumi.get(self, "allow_mac_changes")
 
@@ -3959,7 +4390,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="allowPromiscuous")
     def allow_promiscuous(self) -> pulumi.Output[bool]:
         """
-        Enable promiscuous mode on the network. This flag indicates whether or not all traffic is seen on a given port.
+        Enable promiscuous mode on the network. This
+        flag indicates whether or not all traffic is seen on a given port.
         """
         return pulumi.get(self, "allow_promiscuous")
 
@@ -3999,7 +4431,9 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="blockAllPorts")
     def block_all_ports(self) -> pulumi.Output[bool]:
         """
-        Indicates whether to block all ports by default.
+        Shuts down all ports in the port groups that
+        this policy applies to, effectively blocking all network access to connected
+        virtual devices.
         """
         return pulumi.get(self, "block_all_ports")
 
@@ -4007,7 +4441,11 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="checkBeacon")
     def check_beacon(self) -> pulumi.Output[bool]:
         """
-        Enable beacon probing on the ports this policy applies to.
+        Enables beacon probing as an additional measure
+        to detect NIC failure.
+
+        > **NOTE:** VMware recommends using a minimum of 3 NICs when using beacon
+        probing.
         """
         return pulumi.get(self, "check_beacon")
 
@@ -4071,7 +4509,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="directpathGen2Allowed")
     def directpath_gen2_allowed(self) -> pulumi.Output[bool]:
         """
-        Allow VMDirectPath Gen2 on the ports this policy applies to.
+        Allow VMDirectPath Gen2 for the ports
+        for which this policy applies to.
         """
         return pulumi.get(self, "directpath_gen2_allowed")
 
@@ -4079,7 +4518,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="egressShapingAverageBandwidth")
     def egress_shaping_average_bandwidth(self) -> pulumi.Output[int]:
         """
-        The average egress bandwidth in bits per second if egress shaping is enabled on the port.
+        The average bandwidth in bits
+        per second if egress traffic shaping is enabled on the port.
         """
         return pulumi.get(self, "egress_shaping_average_bandwidth")
 
@@ -4087,7 +4527,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="egressShapingBurstSize")
     def egress_shaping_burst_size(self) -> pulumi.Output[int]:
         """
-        The maximum egress burst size allowed in bytes if egress shaping is enabled on the port.
+        The maximum burst size allowed in
+        bytes if egress traffic shaping is enabled on the port.
         """
         return pulumi.get(self, "egress_shaping_burst_size")
 
@@ -4095,7 +4536,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="egressShapingEnabled")
     def egress_shaping_enabled(self) -> pulumi.Output[bool]:
         """
-        True if the traffic shaper is enabled for egress traffic on the port.
+        `true` if the traffic shaper is enabled
+        on the port for egress traffic.
         """
         return pulumi.get(self, "egress_shaping_enabled")
 
@@ -4103,7 +4545,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="egressShapingPeakBandwidth")
     def egress_shaping_peak_bandwidth(self) -> pulumi.Output[int]:
         """
-        The peak egress bandwidth during bursts in bits per second if egress traffic shaping is enabled on the port.
+        The peak bandwidth during bursts
+        in bits per second if egress traffic shaping is enabled on the port.
         """
         return pulumi.get(self, "egress_shaping_peak_bandwidth")
 
@@ -4111,7 +4554,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter
     def failback(self) -> pulumi.Output[bool]:
         """
-        If true, the teaming policy will re-activate failed interfaces higher in precedence when they come back up.
+        If `true`, the teaming policy will re-activate failed
+        uplinks higher in precedence when they come back up.
         """
         return pulumi.get(self, "failback")
 
@@ -4192,7 +4636,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter
     def hosts(self) -> pulumi.Output[Optional[Sequence['outputs.DistributedVirtualSwitchHost']]]:
         """
-        A host member specification.
+        Use the `host` block to declare a host specification. The
+        options are:
         """
         return pulumi.get(self, "hosts")
 
@@ -4200,7 +4645,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="ignoreOtherPvlanMappings")
     def ignore_other_pvlan_mappings(self) -> pulumi.Output[Optional[bool]]:
         """
-        Whether to ignore existing PVLAN mappings not managed by this resource. Defaults to false.
+        Whether to ignore existing PVLAN
+        mappings not managed by this resource. Defaults to false.
         """
         return pulumi.get(self, "ignore_other_pvlan_mappings")
 
@@ -4208,7 +4654,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="ingressShapingAverageBandwidth")
     def ingress_shaping_average_bandwidth(self) -> pulumi.Output[int]:
         """
-        The average ingress bandwidth in bits per second if ingress shaping is enabled on the port.
+        The average bandwidth in
+        bits per second if ingress traffic shaping is enabled on the port.
         """
         return pulumi.get(self, "ingress_shaping_average_bandwidth")
 
@@ -4216,7 +4663,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="ingressShapingBurstSize")
     def ingress_shaping_burst_size(self) -> pulumi.Output[int]:
         """
-        The maximum ingress burst size allowed in bytes if ingress shaping is enabled on the port.
+        The maximum burst size allowed in
+        bytes if ingress traffic shaping is enabled on the port.
         """
         return pulumi.get(self, "ingress_shaping_burst_size")
 
@@ -4224,7 +4672,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="ingressShapingEnabled")
     def ingress_shaping_enabled(self) -> pulumi.Output[bool]:
         """
-        True if the traffic shaper is enabled for ingress traffic on the port.
+        `true` if the traffic shaper is
+        enabled on the port for ingress traffic.
         """
         return pulumi.get(self, "ingress_shaping_enabled")
 
@@ -4232,7 +4681,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="ingressShapingPeakBandwidth")
     def ingress_shaping_peak_bandwidth(self) -> pulumi.Output[int]:
         """
-        The peak ingress bandwidth during bursts in bits per second if ingress traffic shaping is enabled on the port.
+        The peak bandwidth during
+        bursts in bits per second if ingress traffic shaping is enabled on the port.
         """
         return pulumi.get(self, "ingress_shaping_peak_bandwidth")
 
@@ -4291,7 +4741,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="lacpEnabled")
     def lacp_enabled(self) -> pulumi.Output[bool]:
         """
-        Whether or not to enable LACP on all uplink ports.
+        Enables LACP for the ports that this policy
+        applies to.
         """
         return pulumi.get(self, "lacp_enabled")
 
@@ -4299,7 +4750,7 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="lacpMode")
     def lacp_mode(self) -> pulumi.Output[str]:
         """
-        The uplink LACP mode to use. Can be one of active or passive.
+        The LACP mode. Can be one of `active` or `passive`.
         """
         return pulumi.get(self, "lacp_mode")
 
@@ -4382,7 +4833,9 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="netflowActiveFlowTimeout")
     def netflow_active_flow_timeout(self) -> pulumi.Output[Optional[int]]:
         """
-        The number of seconds after which active flows are forced to be exported to the collector.
+        The number of seconds after which
+        active flows are forced to be exported to the collector. Allowed range is
+        `60` to `3600`. Default: `60`.
         """
         return pulumi.get(self, "netflow_active_flow_timeout")
 
@@ -4390,8 +4843,9 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="netflowCollectorIpAddress")
     def netflow_collector_ip_address(self) -> pulumi.Output[Optional[str]]:
         """
-        IP address for the netflow collector, using IPv4 or IPv6. IPv6 is supported in vSphere Distributed Switch Version 6.0 or
-        later.
+        IP address for the Netflow
+        collector, using IPv4 or IPv6. IPv6 is supported in VDS version 6.0 or later.
+        Must be set before Netflow can be enabled.
         """
         return pulumi.get(self, "netflow_collector_ip_address")
 
@@ -4399,7 +4853,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="netflowCollectorPort")
     def netflow_collector_port(self) -> pulumi.Output[Optional[int]]:
         """
-        The port for the netflow collector.
+        Port for the Netflow collector. This
+        must be set before Netflow can be enabled.
         """
         return pulumi.get(self, "netflow_collector_port")
 
@@ -4407,7 +4862,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="netflowEnabled")
     def netflow_enabled(self) -> pulumi.Output[bool]:
         """
-        Indicates whether to enable netflow on all ports.
+        Enables Netflow on all ports that this policy
+        applies to.
         """
         return pulumi.get(self, "netflow_enabled")
 
@@ -4415,7 +4871,9 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="netflowIdleFlowTimeout")
     def netflow_idle_flow_timeout(self) -> pulumi.Output[Optional[int]]:
         """
-        The number of seconds after which idle flows are forced to be exported to the collector.
+        The number of seconds after which
+        idle flows are forced to be exported to the collector. Allowed range is `10`
+        to `600`. Default: `15`.
         """
         return pulumi.get(self, "netflow_idle_flow_timeout")
 
@@ -4423,7 +4881,9 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="netflowInternalFlowsOnly")
     def netflow_internal_flows_only(self) -> pulumi.Output[Optional[bool]]:
         """
-        Whether to limit analysis to traffic that has both source and destination served by the same host.
+        Whether to limit analysis to
+        traffic that has both source and destination served by the same host.
+        Default: `false`.
         """
         return pulumi.get(self, "netflow_internal_flows_only")
 
@@ -4431,7 +4891,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="netflowObservationDomainId")
     def netflow_observation_domain_id(self) -> pulumi.Output[Optional[int]]:
         """
-        The observation Domain ID for the netflow collector.
+        The observation domain ID for
+        the Netflow collector.
         """
         return pulumi.get(self, "netflow_observation_domain_id")
 
@@ -4439,8 +4900,11 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="netflowSamplingRate")
     def netflow_sampling_rate(self) -> pulumi.Output[Optional[int]]:
         """
-        The ratio of total number of packets to the number of packets analyzed. Set to 0 to disable sampling, meaning that all
-        packets are analyzed.
+        The ratio of total number of packets to
+        the number of packets analyzed. The default is `0`, which indicates that the
+        VDS should analyze all packets. The maximum value is `1000`, which
+        indicates an analysis rate of 0.001%!
+        (MISSING)
         """
         return pulumi.get(self, "netflow_sampling_rate")
 
@@ -4448,7 +4912,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="networkResourceControlEnabled")
     def network_resource_control_enabled(self) -> pulumi.Output[Optional[bool]]:
         """
-        Whether or not to enable network resource control, enabling advanced traffic shaping and resource control features.
+        Set to `true` to enable
+        network I/O control. Default: `false`.
         """
         return pulumi.get(self, "network_resource_control_enabled")
 
@@ -4456,7 +4921,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="networkResourceControlVersion")
     def network_resource_control_version(self) -> pulumi.Output[str]:
         """
-        The network I/O control version to use. Can be one of version2 or version3.
+        The version of network I/O
+        control to use. Can be one of `version2` or `version3`. Default: `version2`.
         """
         return pulumi.get(self, "network_resource_control_version")
 
@@ -4496,7 +4962,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="notifySwitches")
     def notify_switches(self) -> pulumi.Output[bool]:
         """
-        If true, the teaming policy will notify the broadcast network of a NIC failover, triggering cache updates.
+        If `true`, the teaming policy will notify the
+        broadcast network of an uplink failover, triggering cache updates.
         """
         return pulumi.get(self, "notify_switches")
 
@@ -4504,7 +4971,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="portPrivateSecondaryVlanId")
     def port_private_secondary_vlan_id(self) -> pulumi.Output[int]:
         """
-        The secondary VLAN ID for this port.
+        Used to define a secondary VLAN
+        ID when using private VLANs.
         """
         return pulumi.get(self, "port_private_secondary_vlan_id")
 
@@ -4512,7 +4980,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="pvlanMappings")
     def pvlan_mappings(self) -> pulumi.Output[Optional[Sequence['outputs.DistributedVirtualSwitchPvlanMapping']]]:
         """
-        A private VLAN (PVLAN) mapping.
+        Use the `pvlan_mapping` block to declare a
+        private VLAN mapping. The options are:
         """
         return pulumi.get(self, "pvlan_mappings")
 
@@ -4520,7 +4989,10 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="standbyUplinks")
     def standby_uplinks(self) -> pulumi.Output[Sequence[str]]:
         """
-        List of standby uplinks used for load balancing, matching the names of the uplinks assigned in the DVS.
+        A list of standby uplinks to be used in
+        failover. These uplinks need to match the definitions in the
+        `uplinks` VDS argument. See
+        here for more details.
         """
         return pulumi.get(self, "standby_uplinks")
 
@@ -4538,8 +5010,9 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="teamingPolicy")
     def teaming_policy(self) -> pulumi.Output[str]:
         """
-        The network adapter teaming policy. Can be one of loadbalance_ip, loadbalance_srcmac, loadbalance_srcid,
-        failover_explicit, or loadbalance_loadbased.
+        The uplink teaming policy. Can be one of
+        `loadbalance_ip`, `loadbalance_srcmac`, `loadbalance_srcid`,
+        `failover_explicit`, or `loadbalance_loadbased`.
         """
         return pulumi.get(self, "teaming_policy")
 
@@ -4547,8 +5020,8 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="txUplink")
     def tx_uplink(self) -> pulumi.Output[bool]:
         """
-        If true, a copy of packets sent to the switch will always be forwarded to an uplink in addition to the regular packet
-        forwarded done by the switch.
+        Forward all traffic transmitted by ports for which
+        this policy applies to its VDS uplinks.
         """
         return pulumi.get(self, "tx_uplink")
 
@@ -4556,8 +5029,11 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter
     def uplinks(self) -> pulumi.Output[Sequence[str]]:
         """
-        A list of uplink ports. The contents of this list control both the uplink count and names of the uplinks on the DVS
-        across hosts.
+        A list of strings that uniquely identifies the names
+        of the uplinks on the VDS across hosts. The number of items in this list
+        controls the number of uplinks that exist on the VDS, in addition to the
+        names. See here for an example on how to
+        use this option.
         """
         return pulumi.get(self, "uplinks")
 
@@ -4647,7 +5123,28 @@ class DistributedVirtualSwitch(pulumi.CustomResource):
     @pulumi.getter(name="vlanRanges")
     def vlan_ranges(self) -> pulumi.Output[Sequence['outputs.DistributedVirtualSwitchVlanRange']]:
         """
-        The VLAN ID for single VLAN mode. 0 denotes no VLAN.
+        Used to denote VLAN trunking. Use the `min_vlan`
+        and `max_vlan` sub-arguments to define the tagged VLAN range. Multiple
+        `vlan_range` definitions are allowed, but they must not overlap. Example
+        below:
+
+        <!--Start PulumiCodeChooser -->
+        ```python
+        import pulumi
+        import pulumi_vsphere as vsphere
+
+        vds = vsphere.DistributedVirtualSwitch("vds", vlan_ranges=[
+            vsphere.DistributedVirtualSwitchVlanRangeArgs(
+                max_vlan=199,
+                min_vlan=100,
+            ),
+            vsphere.DistributedVirtualSwitchVlanRangeArgs(
+                max_vlan=399,
+                min_vlan=300,
+            ),
+        ])
+        ```
+        <!--End PulumiCodeChooser -->
         """
         return pulumi.get(self, "vlan_ranges")