Create an OS profile

task australia Updated Sep 10, 2026 2 min read create-os-profile.md
Raw file servicenow.com

An OS profile installs a specified image on a newly-provisioned virtual machine. You map an OS profile to a cloud account, a location (datacenter), an image template, and a cloud script. OS profiles are provider-agnostic and you can use the same profile for multiple cloud accounts.

Before you begin

  • You must have a cloud account with datacenters. You must run Discovery on the service accounts to populate the datacenters.
  • Role required: sn_cmp.cloud_admin

About this task

Note: Profile mappings that specify more details run first. For example, a mapping that specifies a blueprint, OS profile, and resource alias takes precedence over a mapping that specifies only an OS profile.

Procedure

  1. In the Cloud Admin Portal, navigate to Manage > Resource Profiles.

  2. In the Profiles list, select OS Profile and then click New.

  3. Enter a unique and descriptive Name and Description for the profile and then click Submit.

    The profile is created.

  4. Map the profile to a template.

    1. In the list, click the profile that you created.

    2. In the OS Profile Mappings related list, click New, fill in the form, and then click Submit.

      [Omitted image "os-profile-mapping.png"] Alt text: OS profile mappings

Field

Description

Cloud Account

Select the cloud account to map the OS profile to.

Location

Select a datacenter in the cloud account.

Image Template [cmdb_ci_os_template]

Select an image template that the profile should be mapped to. Click the reference icon ([Omitted image "icon-reference.png"] Alt text: Reference icon) to view the details of the template.

Important: Do not create a new image template. Image templates must be discovered from the Cloud Accounts page on the Cloud Admin Portal (Manage > Cloud Accounts).

When you add credentials to an image template, the credentials are inherited by all VMs that are provisioned using the template. See Add credentials to an image template.

5. Map the profile to a cloud script. In this procedure, you specify an existing script. See [Create cloud initialization script templates and a script](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-operations-management/cloud-configuration-governance/create-cloud-init-template-and-script.md).
1.  On the Cloud Script OS Profile Mappings related list, click **New** and then fill in the form.

Field

Description

Blueprint[Optional]

Select a blueprint to limit the script to a specific resource block used in the blueprint.

Cloud script

Select a cloud script to map the OS profile to.

Active

Select the check box if the cloud script should be run after the virtual machine is provisioned.

Application

Cloud Provisioning and Governance is auto-selected.

OS profile

If you specify a blueprint, the cloud script is run when the blueprint is provisioned.

Resource Alias[Optional]

If you specify a resource alias for the blueprint, then the cloud script is executed when the blueprint with the specified resource alias is provisioned.

2. Right-click the form header and select **Save**.
    The **Name** attribute `[scriptName]` appears in the OS Profile Mapping Overrides list.

3.  In the OS Profile Mapping Overrides list, enter an attribute name and value to use when the resource is provisioned.
Search documentation
Search document titles and file paths on the australia branch