assign-offline-profile

Binds users and teams to a Dataverse Mobile Offline Profile via Web API membership records.

808|167|Updated Jan 21, 2026
One-click install
npx skills add https://github.com/microsoft/power-platform-skills --skill assign-offline-profile
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: assign-offline-profile
Source: https://github.com/microsoft/power-platform-skills/tree/main/plugins/mobile-apps/skills/assign-offline-profile
Command: npx skills add https://github.com/microsoft/power-platform-skills --skill assign-offline-profile

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

A Mobile Offline Profile created in Dataverse does nothing until users or teams are explicitly bound to it. This Skill closes that gap by assigning (or unassigning) users and teams to an existing profile so their mobile apps actually receive offline sync.

Core Features & Use Cases

  • Membership assignment: POSTs usermobileofflineprofilemembership and teammobileofflineprofilemembership records via the Dataverse Web API, with support for --user, --team, --me, and --all-app-users flags.
  • Idempotent diffing: Discovers existing memberships first, then presents a single confirmation gate showing adds, removals, skips, and unresolvable entries before writing.
  • Verification and recovery: Re-queries memberships after writes to confirm the diff applied, and supports safe re-runs plus --unassign-* flags to undo bindings.
  • Use Case: After creating an offline profile for a field-service app, run this Skill with --all-app-users so every system user receives the profile on their next mobile sign-in.

Quick Start

Ask the agent to assign the current offline profile to specific users or teams, for example by providing UPNs or a team name to bind to the profile.

Frequently Asked Questions about assign-offline-profile

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

FAQPage Schema
How do I assign a Mobile Offline Profile to users in Dataverse?

Create records in the usermobileofflineprofilemembership entity binding the profile ID to each systemuser ID via the Dataverse Web API. This Skill automates the lookup, diff confirmation, and POST calls for users and teams.

Why is offline sync not working after I created an offline profile?

Creating the profile only defines it in Dataverse; no app uses it until users or teams are bound through membership records. Assign the profile to users, then have them sign out and back in to trigger the profile pull.

Can I assign an offline profile to a team instead of individual users?

Yes, teammobileofflineprofilemembership records bind a profile to a team. Only teams with teamtype 0 (Manage Teams) are eligible; Access Teams and Owner Teams are excluded from profile assignment.

What happens if I assign the same user to an offline profile twice?

POSTing a duplicate membership returns a 409 Conflict, which the workflow treats as a silent success. The Skill also pre-queries existing memberships so already-bound users are skipped as no-ops, making re-runs idempotent.

How do I remove a user from a Mobile Offline Profile?

Delete the corresponding usermobileofflineprofilemembership record by its membership ID. This Skill supports --unassign-user and --unassign-team flags that resolve and DELETE the existing membership records.