---
sourceDocument: Yokohama IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/yokohama/it-operations-management

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Map a script to an OS profile

# Map a script to an OS profile {#ariaid-title1}

* Release version: Yokohama
* 
* Updated August 11, 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

To execute scripted actions during VM provisioning, you can map a script to an OS
profile. The script runs on VMs that are created based on the image template in the OS
profile.

## Before you begin

Role required: sn_cmp.cloud_admin

You must have a cloud account with datacenters. You must run Discovery on the service accounts to populate the datacenters.

## About this task

In this procedure, you specify an existing script. See [Create cloud initialization script templates and a script](https://servicenow-prod.fluidtopics.net/wImxSG0xAN1ju45Pv8Tncw "Create cloud initialization templates and a script to use during VM provisioning.").  
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 ManageResource Profiles.
2. In the Profiles list, select OS Profile and then open the profile.
3. On the Cloud Script OS Profile Mappings related list, click New and then fill in the form.  
   {#map-script-to-os-profile__table_xrk_qsj_jfb__entry__2}

   | 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. |
   [ ]

   {#map-script-to-os-profile__table_xrk_qsj_jfb}
4. Right-click the form header and select Save.  
   The Name attribute `[scriptName]` appears in the OS Profile Mapping Overrides list.
5. In the OS Profile Mapping Overrides list, enter an attribute name and value to use when the resource is provisioned.
**Related tasks**   

* [Create an OS profile](https://servicenow-prod.fluidtopics.net/K9tHDAniswJ3jLMrYErweg "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.")

*[\>]: and then