Skip to main content

UIPlugin

Properties​

NameTypeDescriptionNotes
PluginInstanceIdStringUnique identifier of the plugin instance[required]
AliasStringTenant-unique alias for the plugin instance, normalized to lowercase[required]
Namemap[string]StringLocalized string keyed by locale code. At least one non-empty locale entry is required on create/update. Conventionally includes en.[required]
Descriptionmap[string]StringLocalized string keyed by locale code. At least one non-empty locale entry is required on create/update. Conventionally includes en.[required]
ApiScopes[]StringOAuth scopes the plugin requests at registration[required]
ContentSecurityPoliciesmap[string]String[]Map of directive name to allowlist values. Used for CSP, Permissions-Policy, and iframe-allow on create/update. Only platform allowlisted directives/keywords are accepted (see UMS validators).[required]
PermissionPolicymap[string]String[]Map of directive name to allowlist values. Used for CSP, Permissions-Policy, and iframe-allow on create/update. Only platform allowlisted directives/keywords are accepted (see UMS validators).[required]
IframeAllowmap[string]String[]Map of directive name to allowlist values. Used for CSP, Permissions-Policy, and iframe-allow on create/update. Only platform allowlisted directives/keywords are accepted (see UMS validators).[required]
IframeSandbox[]StringOpt-in iframe sandbox grants, de-duplicated and sorted. Empty when the plugin has none, including instances created before this field existed.[required]
ActiveAssetBundleIdStringCurrently active asset bundle, or null/omitted if none uploaded yet[optional]
Slots[]PluginSlot[required]
StatePluginInstanceState[required]
CreatedSystem.DateTimeISO 8601 creation timestamp[required]
ModifiedSystem.DateTimeISO 8601 last-modified timestamp[required]

Examples​

  • Prepare the resource
$UIPlugin = Initialize-UIPlugin -PluginInstanceId 2c918086-7b5f-4b3e-8a1c-2d3e4f5a6b7c `
-Alias my-custom-plugin `
-Name {"en":"Example text","fr":"Texte d'exemple"} `
-Description {"en":"Example text","fr":"Texte d'exemple"} `
-ApiScopes ["idn:account:read"] `
-ContentSecurityPolicies {"default-src":["'self'"]} `
-PermissionPolicy {"default-src":["'self'"]} `
-IframeAllow {"default-src":["'self'"]} `
-IframeSandbox ["allow-modals","allow-popups"] `
-ActiveAssetBundleId null `
-Slots null `
-State null `
-Created 2024-08-16T14:16:58.389Z `
-Modified 2024-08-16T14:16:58.389Z
  • Convert the resource to JSON
$UIPlugin | ConvertTo-JSON

[Back to top]