developer.sailpoint.com/docs/tools/sdk/powershell/Reference/V3/Models/Role.md

id, title, pagination_label, sidebar_label, sidebar_class_name, keywords, slug, tags

id	title	pagination_label	sidebar_label	sidebar_class_name	keywords	slug	tags
role	Role	Role	Role	powershellsdk	powershell PowerShell sdk Role Role	/tools/sdk/powershell/v3/models/role	SDK Software Development Kit Role Role

Role

Properties

Name	Type	Description	Notes
Id	Pointer to String	The id of the Role. This field must be left null when creating an Role, otherwise a 400 Bad Request error will result.	[optional]
Name	String	The human-readable display name of the Role	[required]
Created	Pointer to System.DateTime	Date the Role was created	[optional] [readonly]
Modified	Pointer to System.DateTime	Date the Role was last modified.	[optional] [readonly]
Description	Pointer to String	A human-readable description of the Role	[optional]
Owner	OwnerReference		[required]
AccessProfiles	Pointer to []AccessProfileRef		[optional]
Entitlements	Pointer to []EntitlementRef		[optional]
Membership	Pointer to RoleMembershipSelector		[optional]
LegacyMembershipInfo	Pointer to [map[string]AnyType]https://learn.microsoft.com/en-us/powershell/scripting/lang-spec/chapter-04?view=powershell-7.4	This field is not directly modifiable and is generally expected to be null. In very rare instances, some Roles may have been created using membership selection criteria that are no longer fully supported. While these Roles will still work, they should be migrated to STANDARD or IDENTITY_LIST selection criteria. This field exists for informational purposes as an aid to such migration.	[optional]
Enabled	Pointer to Boolean	Whether the Role is enabled or not.	[optional] [default to $false]
Requestable	Pointer to Boolean	Whether the Role can be the target of access requests.	[optional] [default to $false]
AccessRequestConfig	Pointer to RequestabilityForRole		[optional]
RevocationRequestConfig	Pointer to RevocabilityForRole		[optional]
Segments	Pointer to []String	List of IDs of segments, if any, to which this Role is assigned.	[optional]
Dimensional	Pointer to Boolean	Whether the Role is dimensional.	[optional] [default to $false]
DimensionRefs	Pointer to []DimensionRef	List of references to dimensions to which this Role is assigned. This field is only relevant if the Role is dimensional.	[optional]
AccessModelMetadata	Pointer to AttributeDTOList		[optional]

Examples

• Prepare the resource

$Role = Initialize-PSSailpoint.V3Role  -Id 2c918086749d78830174a1a40e121518 `
 -Name Role 2567 `
 -Created 2021-03-01T22:32:58.104Z `
 -Modified 2021-03-02T20:22:28.104Z `
 -Description Urna amet cursus pellentesque nisl orci maximus lorem nisl euismod fusce morbi placerat adipiscing maecenas nisi tristique et metus et lacus sed morbi nunc nisl maximus magna arcu varius sollicitudin elementum enim maecenas nisi id ipsum tempus fusce diam ipsum tortor. `
 -Owner null `
 -AccessProfiles null `
 -Entitlements null `
 -Membership null `
 -LegacyMembershipInfo {type=IDENTITY_LIST} `
 -Enabled true `
 -Requestable true `
 -AccessRequestConfig null `
 -RevocationRequestConfig null `
 -Segments [f7b1b8a3-5fed-4fd4-ad29-82014e137e19, 29cb6c06-1da8-43ea-8be4-b3125f248f2a] `
 -Dimensional null `
 -DimensionRefs null `
 -AccessModelMetadata null

• Convert the resource to JSON

$Role | ConvertTo-JSON

[Back to top]