Skip to main content

CampaignGet

Properties​

NameTypeDescriptionNotes
IdStringID of the campaign[optional] [readonly]
NameStringThe campaign name.[required]
DescriptionStringThe campaign description.[required]
DeadlineSystem.DateTimeThe campaign's completion deadline date. While creating campaign, If deadline is passed as empty then automatically it will be set for two weeks later from current time.[optional]
DeadlineTimezoneStringThe timezone must be in a valid ISO 8601 format. Timezones in ISO 8601 are represented as UTC (represented as 'Z') or as an offset from UTC. The offset format can be +/-hh:mm, +/-hhmm, or +/-hh.[optional]
DeadlineTimeSystem.DateTimeCalculated deadline time in UTC timezone of the campaign calculated from the deadline and the deadlineTimezone[optional]
EmailNotificationEnabledBooleanEnables email notification for this campaign[optional] [default to $false]
AutoRevokeAllowedBooleanAllows auto revoke for this campaign[optional] [default to $false]
AutoActivateBooleanIf true, the campaign is set to activate automatically after generation completes. Campaigns stored without this attribute default to false.[optional] [default to $false]
RecommendationsEnabledBooleanEnables IAI for this campaign. Accepts true even if the IAI product feature is off. If IAI is turned off then campaigns generated from this template will indicate false. The real value will then be returned if IAI is ever enabled for the org in the future.[optional] [default to $false]
SunsetCommentsRequiredBooleanDetermines if comments on sunset date changes are required.[optional] [default to $true]
TypeCampaignType[required]
ReviewerReviewer[required]
Alerts[]AlertA list of errors and warnings that have accumulated.[optional] [readonly]
FilterRefCampaignFilterRef[optional]
InlineFilterCampaignFilterInline[optional]
SearchBasedParamsCampaignSearchBasedParams[optional]
RemediatorRefCampaignRemediatorRef[optional]
OwnerIdStringThe campaign owner is the Identity that created the campaign.[optional]
CreatedSystem.DateTimeCreated time of the campaign[optional] [readonly]
ModifiedSystem.DateTimeModified time of the campaign[optional] [readonly]
TotalCertificationsInt32The total number of certifications in this campaign.[optional] [readonly]
CompletedCertificationsInt32The number of completed certifications in this campaign.[optional] [readonly]
MandatoryCommentRequirementCampaignMandatoryCommentRequirement[optional]
StatusEnum [ "PENDING", "STAGED", "CANCELING", "ACTIVATING", "ACTIVE", "COMPLETING", "COMPLETED", "ERROR" ]The campaign's current status.[optional] [readonly]
LatestReportsmap[string]CampaignLatestReportA map of the latest report for each report type[optional]
SourceIds[]StringA direct list of sourceIds to include in this campaign.[optional]
SourcesWithOrphanEntitlements[]CampaignOrphanEntitlementSourceSources that have orphan entitlement line items for this campaign, as supplied when the campaign finished staging. Each entry identifies a source by id and name.[optional] [readonly]

Examples​

  • Prepare the resource
$CampaignGet = Initialize-CampaignGet -Id 2c9079b2-70a2-66a6-a170-a2779fcb0007 `
-Name Manager Campaign `
-Description Everyone needs to be reviewed by their manager `
-Deadline Sun Mar 15 00:00:00 UTC 2020 `
-DeadlineTimezone -05:00 `
-DeadlineTime 2018-10-19T13:49:37.385Z `
-EmailNotificationEnabled false `
-AutoRevokeAllowed false `
-AutoActivate false `
-RecommendationsEnabled true `
-SunsetCommentsRequired true `
-Type null `
-Reviewer null `
-Alerts null `
-FilterRef null `
-InlineFilter null `
-SearchBasedParams null `
-RemediatorRef null `
-OwnerId 4030ca72bdfb4980b51b8fcee948be50 `
-Created 2020-03-03T22:15:13.611Z `
-Modified 2020-03-03T22:20:12.674Z `
-TotalCertifications 100 `
-CompletedCertifications 10 `
-MandatoryCommentRequirement null `
-Status ACTIVE `
-LatestReports {'STATUS': {...},'SIGN_OFF': {...}} `
-SourceIds ["0fbe863c063c4c88a35fd7f17e8a3df5"] `
-SourcesWithOrphanEntitlements [{"type":"SOURCE","id":"30e6435e60bf47b0bc11622c31dfdbfd","name":"Active Directory"}]
  • Convert the resource to JSON
$CampaignGet | ConvertTo-JSON

[Back to top]