Virtual Media Policy

A Virtual Media Policy enables remote mounting of ISO or disk images to servers via KVM or CIMC. It is commonly used to mount OS installation media during provisioning. Each policy can define multiple mappings pointing to NFS, CIFS, HTTP, or HTTPS file shares.

Location in Intersight GUI: Policies » Virtual Media

Diagram

Classes

policies (compute.intersight.organizations)

Name	Type	Constraint	Mandatory	Default Value
virtual_media	List	`[virtual_media]`	No

virtual_media (compute.intersight.organizations.policies)

Name	Type	Constraint	Mandatory	Default Value
name	String	Regex: `^[a-zA-Z0-9_.:-]{1,64}$`	Yes
description	String		No
managed	Boolean	`true`, `false`	No	`true`
tags	List	`[tags]`	No
enabled	Boolean	`true`, `false`	No	`true`
encryption	Boolean	`true`, `false`	No	`true`
low_power_usb	Boolean	`true`, `false`	No	`true`
mappings	List	`[mappings]`	No

tags (compute.intersight.organizations.policies.virtual_media)

Name	Type	Constraint	Mandatory	Default Value
key	String		Yes
value	String		Yes

mappings (compute.intersight.organizations.policies.virtual_media)

Name	Type	Constraint	Mandatory	Default Value
volume_name	String		Yes
device_type	Choice	`cdd`, `hdd`	No	`cdd`
mount_protocol	Choice	`nfs`, `cifs`, `http`, `https`	No	`nfs`
file_location	String		No
mount_options	String		No
username	String		No
password	String		No
authentication_protocol	Choice	`none`, `ntlm`, `ntlmi`, `ntlmv2`, `ntlmv2i`, `ntlmssp`, `ntlmsspi`	No	`none`

Examples

Example-1: The example below demonstrates a virtual media policy that mounts an OS installation ISO from an NFS share.

compute:
  intersight:
    organizations:
      - name: MyOrganization
        policies:
          virtual_media:
            - name: os-install-media
              description: Mount RHEL 9 ISO from NFS
              mappings:
                - volume_name: rhel9-iso
                  device_type: cdd
                  mount_protocol: nfs
                  file_location: "nfs://10.0.0.10/exports/iso/rhel-9.4-x86_64-dvd.iso"
              tags:
                - key: env
                  value: prod

Example-2: The example below demonstrates mounting an image from an HTTPS server with authentication.

compute:
  intersight:
    organizations:
      - name: MyOrganization
        policies:
          virtual_media:
            - name: secure-media
              mappings:
                - volume_name: esxi8-iso
                  device_type: cdd
                  mount_protocol: https
                  file_location: "https://files.example.com/images/VMware-ESXi-8.0.iso"
                  username: mediauser
                  password: !env MEDIA_PASSWORD