create-webroles

Defines and assigns web roles for a Power Pages code site.

647|132|Updated Jan 21, 2026
One-click install
npx skills add https://github.com/microsoft/power-platform-skills --skill create-webroles
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-webroles
Source: https://github.com/microsoft/power-platform-skills/tree/main/plugins/power-pages/skills/create-webroles
Command: npx skills add https://github.com/microsoft/power-platform-skills --skill create-webroles

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Web roles define access and permissions for site users in a Power Pages code site, enabling controlled authentication and authorization governance for pages and content.

Core Features & Use Cases

  • Create and manage web roles for a Power Pages code site, including Administrators, Authenticated Users, Anonymous Users, and custom roles.
  • Enforce uniqueness of anonymoususersrole and authenticatedusersrole flags across roles, store roles as YAML in .powerpages-site/web-roles, and use UUIDs for identity.
  • Integrate with deployment workflows so new roles are applied to the live site after creation.

Quick Start

Define the desired web roles for your Power Pages site and deploy to apply them.

Frequently Asked Questions about create-webroles

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create and assign web roles for a Power Pages code site?

To create web roles for a Power Pages code site, define them as YAML files within the .powerpages-site/web-roles directory. You must generate valid UUIDs for role identity and enforce uniqueness for anonymous and authenticated user flags before deploying.

What are web roles used for in Power Pages deployment pipelines?

Web roles in Power Pages deployment pipelines manage site access and permissions. They define authorization governance for pages and content across Administrators, Authenticated Users, Anonymous Users, and custom roles during site administration workflows.

Do I need to generate UUIDs manually when defining Power Pages web roles?

Yes, you need valid UUIDs for identity when defining Power Pages web roles. The provided script generates these required UUIDs to ensure each role has a unique identifier within the YAML configuration files.

Why does my Power Pages web role configuration require unique anonymous and authenticated flags?

Power Pages web role configuration requires unique anonymoususersrole and authenticatedusersrole flags to prevent authorization conflicts. Enforcing this uniqueness ensures only one role governs anonymous access and one governs authenticated access across the site.

Can I manage custom user roles alongside default roles in Power Pages?

Yes, you can manage custom user roles alongside default Administrators, Authenticated Users, and Anonymous Users in Power Pages. Custom roles are stored as YAML files and integrated into deployment workflows to apply permissions to the live site.

What is the best way to apply new web roles to a live Power Pages site?

The best way to apply new web roles to a live Power Pages site is through deployment workflows. After defining roles and generating UUIDs in YAML files, deploying the configuration updates the live site with the new access permissions.