Konfigurieren der Argumente für integrierte Lebenszyklusworkflowtasks
Mit der Lebenszyklus-Workflows-API in Microsoft Graph können Sie grundlegende Lebenszyklusprozesse für Ihre Benutzer auf drei Ebenen automatisieren: Joiner, Leaver und Mover. Kern der Workflows sind Aufgaben , die die spezifischen Aktionen darstellen, die automatisch ausgeführt werden, wenn ein Workflow ausgelöst wird.
Microsoft Graph unterstützt 24 integrierte Aufgaben , mit denen Sie Ihre benutzerdefinierten Workflows erstellen können. Jede Aufgabe verfügt über einen Satz von Argumenten, die für diese Aufgabe zulässig sind. Beispielsweise können Sie mit einer Aufgabe zum Generieren eines temporären Zugriffspasses (TAP) für einen Benutzer die Lebensdauer des TAP konfigurieren und festlegen, ob der Benutzer es wiederverwenden kann. Eine Aufgabe zum Hinzufügen eines Benutzers zu einer Gruppe erfordert, dass Sie die Gruppen angeben, denen Sie den Benutzer hinzufügen möchten. Diese Konfiguration wird für die Arguments-Eigenschaft einer Aufgabe vorgenommen.
Dieser Artikel enthält Anleitungen zur zulässigen Konfiguration für die Arguments-Eigenschaft von Aufgaben in Lebenszyklusworkflows.
Konfigurieren von Argumenten für Aufgaben
Anzeigename der Aufgabe | taskDefinitionId | Argumente |
---|---|---|
Senden einer Begrüßungs-E-Mail an neu eingestellte Mitarbeiter | 70b29d51-b59a-4773-9280-8841dfd3f2ea |
name: cc value: Eine gültige Benutzer-ID (Zeichenfolge) für den Benutzer, den Sie in der E-Mail cc senden möchten. name: customSubject value: Ein benutzerdefinierter Betreffheader für die gesendete E-Mail. name: customBody value: Der Text der angepassten E-Mail. name: locale value: Sprachwert, der die Spracheinstellungen des E-Mail-Empfängers überschreibt. Dieses Argument passt den benutzerdefinierten Text der E-Mail nicht an und sollte in derselben Sprache wie der benutzerdefinierte Text festgelegt werden. |
Senden einer Erinnerungs-E-Mail für das Onboarding | 3C860712-2D37-42A4-928F-5C93935D26A1 |
name: cc value: Eine gültige Benutzer-ID (Zeichenfolge) für den Benutzer, den Sie in der E-Mail cc senden möchten. name: customSubject value: Ein benutzerdefinierter Betreffheader für die gesendete E-Mail. name: customBody value: Der Text der angepassten E-Mail. name: locale value: Sprachwert, der die Spracheinstellungen des E-Mail-Empfängers überschreibt. Dieses Argument passt den benutzerdefinierten Text der E-Mail nicht an und sollte in derselben Sprache wie der benutzerdefinierte Text festgelegt werden. |
Generieren eines temporären Zugriffspasses und Senden per E-Mail an den Vorgesetzten des Benutzers | 1b555e50-7f65-41d5-b514-5894a026d10d |
name: tapLifetimeMinutes value: 10 upto 43000 name: tapIsUsableOnce Value: true oder false Voraussetzungen:
|
Hinzufügen eines Benutzers zu Gruppen | 22085229-5809-45e8-97fd-270d28d66910 |
name: groupID value: eine gültige Gruppen-ID oder eine durch Trennzeichen getrennte Liste von Gruppen, denen der Benutzer als Mitglied hinzugefügt wird. Beispiel: "06269010-2d8e-48e4-8f0e-33580720c9e1, 06bba22c-775e-42d8-b451-4221af061af0, 182f68db-6513-4e79-9ec2-a7e89a460e7f" |
Hinzufügen eines Benutzers zu Teams | e440ed8d-25a1-4618-84ce-091ed5be5594 |
name: teamID value: eine gültige Gruppen-ID oder eine durch Trennzeichen getrennte Liste von Teams, zu denen der Benutzer als Mitglied hinzugefügt wird. Beispiel: "06269010-2d8e-48e4-8f0e-33580720c9e1, 06bba22c-775e-42d8-b451-4221af061af0, 182f68db-6513-4e79-9ec2-a7e89a460e7f" |
Aktivieren eines Benutzerkontos | 6fc52c9d-398b-4305-9763-15f42c1676fc |
name: enableOnPremisesAccount value: Ein boolescher Wert, der angibt, ob die Aufgabe synchronisierte lokale Benutzerkonten aktiviert. |
Ausführen einer benutzerdefinierten Aufgabenerweiterung | 4262b724-8dba-4fad-afc3-43fcbb497a0e | Namen: CustomTaskExtensionID value: Die ID der benutzerdefinierten Aufgabenerweiterung |
Zuweisen von Lizenzen zu Benutzern (Vorschau) | 683c87a4-2ad4-420b-97d4-220d90afcd24 | Namen: licenses value: Die ID der Lizenz, die Sie zuweisen möchten. |
Entfernen ausgewählter Lizenzzuweisungen vom Benutzer (Vorschau) | 5fc402a8-daaf-4b7b-9203-da868b05fc5f | Namen: licenses value: Die ID der Lizenz, die Sie zuweisen möchten. |
Ausführen einer benutzerdefinierten Aufgabenerweiterung | 4262b724-8dba-4fad-afc3-43fcbb497a0e |
name: CustomTaskExtensionID value: Die ID der benutzerdefinierten Aufgabenerweiterung |
Benutzerkonto deaktivieren | 1dfdfcc7-52fa-4c2e-bf3a-e3919cc12950 |
name: disableOnPremisesAccount value: Ein boolescher Wert, der angibt, ob die Aufgabe synchronisierte lokale Benutzerkonten deaktiviert. |
Entfernen eines Benutzers aus ausgewählter Gruppe | 1953a66c-751c-45e5-8bfe-01462c70da3c |
name: groupID value: eine gültige Gruppen-ID oder eine durch Trennzeichen getrennte Liste von Gruppen, in denen der Benutzer Mitglied ist. Beispiel: "06269010-2d8e-48e4-8f0e-33580720c9e1, 06bba22c-775e-42d8-b451-4221af061af0, 182f68db-6513-4e79-9ec2-a7e89a460e7f" |
Entfernen von Benutzern aus allen Gruppen | b3a31406-2a15-4c9a-b25b-a658fa5f07fc | Keine |
Entfernen eines Benutzers aus Teams | 06aa7acb-01af-4824-8899-b14e5ed788d6 |
name: teamID value: Eine durch Trennzeichen getrennte Liste von Teams, in denen der Benutzer Mitglied ist. Beispiel: "06269010-2d8e-48e4-8f0e-33580720c9e1, 06bba22c-775e-42d8-b451-4221af061af0, 182f68db-6513-4e79-9ec2-a7e89a460e7f" |
Entfernen eines Benutzers aus allen Teams | 81f7b200-2816-4b3b-8c5d-dc556f07b024 | Keine |
Entfernen aller Lizenzzuweisungen vom Benutzer | 8fa97d28-3e52-4985-b3a9-a1126f9b8b4e | Keine |
Benutzer löschen | 8d18588d-9ad3-4c0f-99d0-ec215f0e3dff |
name: deleteOnPremisesAccount value: Ein boolescher Wert, der angibt, ob die Aufgabe synchronisierte lokale Benutzerkonten löscht. |
Senden einer E-Mail, um den Manager über die Verschiebung des Benutzers zu benachrichtigen | aab41899-9972-422a-9d97-f626014578b7 |
name: cc value: Eine gültige Benutzer-ID (Zeichenfolge) für den Benutzer, den Sie in der E-Mail cc senden möchten. name: customSubject value: Ein benutzerdefinierter Betreffheader für die gesendete E-Mail. name: customBody value: Der Text der angepassten E-Mail. name: locale value: Sprachwert, der die Spracheinstellungen des E-Mail-Empfängers überschreibt. Passt den benutzerdefinierten Text der E-Mail nicht an und sollte in derselben Sprache wie der benutzerdefinierte Text festgelegt werden. |
Senden einer E-Mail an den Vorgesetzten vor dem letzten Tag des Benutzers | 52853a3e-f4e5-4eb8-bb24-1ac09a1da935 |
name: cc value: Eine gültige Benutzer-ID (Zeichenfolge) für den Benutzer, den Sie in der E-Mail cc senden möchten. name: customSubject value: Ein benutzerdefinierter Betreffheader für die gesendete E-Mail. name: customBody value: Der Text der angepassten E-Mail. name: locale value: Sprachwert, der die Spracheinstellungen des E-Mail-Empfängers überschreibt. Passt den benutzerdefinierten Text der E-Mail nicht an und sollte in derselben Sprache wie der benutzerdefinierte Text festgelegt werden. |
Senden von E-Mails an Benutzer am letzten Tag | 9c0a1eaf-5bda-4392-9d9e-6e155bb57411 |
name: cc value: Eine gültige Benutzer-ID (Zeichenfolge) für den Benutzer, den Sie in der E-Mail cc senden möchten. name: customSubject value: Ein benutzerdefinierter Betreff für die gesendete E-Mail. name: customBody value: Der Text der angepassten E-Mail. name: locale value: Sprachwert, der die Spracheinstellungen des E-Mail-Empfängers überschreibt. Passt den benutzerdefinierten Text der E-Mail nicht an und sollte in derselben Sprache wie der benutzerdefinierte Text festgelegt werden. |
Senden von Offboarding-E-Mails an den Vorgesetzten der Benutzer nach dem letzten Tag | 6f22ddd4-b3a5-47a4-a846-0d7c201a49ce |
name: cc value: Eine gültige Benutzer-ID (Zeichenfolge) für den Benutzer, den Sie in der E-Mail cc senden möchten. name: customSubject value: Ein benutzerdefinierter Betreffheader für die gesendete E-Mail. name: customBody value: Der Text der angepassten E-Mail. name: locale value: Sprachwert, der die Spracheinstellungen des E-Mail-Empfängers überschreibt. Passt den benutzerdefinierten Text der E-Mail nicht an und sollte in derselben Sprache wie der benutzerdefinierte Text festgelegt werden. |
Anfordern der Zuweisung von Benutzerzugriffspaketen | c1ec1e76-f374-4375-aaa6-0bb6bd4c60be |
name: assignmentPolicyId value: Eine gültige Zuweisungsrichtlinien-ID (Zeichenfolge) für das Zugriffspaket, das Sie dem Benutzer zuweisen möchten. name: accessPackageId value: Eine gültige Zugriffspaket-ID für das Zugriffspaket, das Sie dem Benutzer zuweisen möchten. |
Entfernen der Zugriffspaketzuweisung für den Benutzer | 4a0b64f2-c7ec-46ba-b117-18f262946c50 |
name: accessPackageId value: Eine gültige Zugriffspaket-ID für das Zugriffspaket, das Sie dem Benutzer zuweisen möchten. |
Entfernen aller Zugriffspaketzuweisungen für Benutzer | 42ae2956-193d-4f39-be06-691b8ac4fa1d | Keine |
Abbrechen ausstehender Zugriffspaketzuweisungsanforderungen für Den Benutzer | 498770d9-bab7-4e4c-b73d-5ded82a1d0b3 | Keine |
Beispiele
Beispiel 1: Senden einer Begrüßungs-E-Mail an einen neuen Mitarbeiter
{
"category": "joiner",
"continueOnError": false,
"description": "Send welcome email to new hire",
"displayName": "Send Welcome Email",
"isEnabled": true,
"taskDefinitionId": "70b29d51-b59a-4773-9280-8841dfd3f2ea",
"arguments": [
{
"name": "cc",
"value": "e94ad2cd-d590-4b39-8e46-bb4f8e293f85,ac17d108-60cd-4eb2-a4b4-084cacda33f2"
},
{
"name": "customSubject",
"value": "Welcome to the organization {{userDisplayName}}!"
},
{
"name": "customBody",
"value": "Welcome to our organization {{userGivenName}} {{userSurname}}.\n\nFor more information, reach out to your manager {{managerDisplayName}} at {{managerEmail}}."
},
{
"name": "locale",
"value": "en-us"
}
]
}
Beispiel 2: Generieren eines temporären Zugriffspasses (Temporary Access Pass, TAP) und Senden an den Vorgesetzten des Benutzers
{
"category": "joiner",
"continueOnError": false,
"description": "Generate Temporary Access Pass and send via email to user's manager",
"displayName": "Generate TAP and Send Email",
"isEnabled": true,
"taskDefinitionId": "1b555e50-7f65-41d5-b514-5894a026d10d",
"arguments": [
{
"name": "tapLifetimeMinutes",
"value": "480"
},
{
"name": "tapIsUsableOnce",
"value": "false"
},
{
"name": "cc",
"value": "068fa0c1-fa00-4f4f-8411-e968d921c3e7,9d208c40-7eb6-46ff-bebd-f30148c39b47"
},
{
"name": "customSubject",
"value": "Temporary access pass for your new employee {{userDisplayName}}"
},
{
"name": "customBody",
"value": "Hello {{managerDisplayName}}\n\nPlease find the temporary access pass for your new employee {{userDisplayName}} below:\n\n{{temporaryAccessPass}}\n\nRegards\nYour IT department"
},
{
"name": "locale",
"value": "en-us"
}
]
}
Beispiel 3: Hinzufügen eines Benutzers zu Gruppen
{
"category": "joiner,leaver",
"description": "Add user to groups",
"displayName": "AddUserToGroup",
"isEnabled": true,
"continueOnError": true,
"taskDefinitionId": "22085229-5809-45e8-97fd-270d28d66910",
"arguments": [
{
"name": "groupID",
"value": "06269010-2d8e-48e4-8f0e-33580720c9e1, 06bba22c-775e-42d8-b451-4221af061af0, 182f68db-6513-4e79-9ec2-a7e89a460e7f"
}
]
}
Beispiel 4: Hinzufügen eines Benutzers zu Teams
{
"category": "joiner,leaver",
"description": "Add user to team",
"displayName": "AddUserToTeam",
"isEnabled": true,
"continueOnError": true,
"taskDefinitionId": "e440ed8d-25a1-4618-84ce-091ed5be5594",
"arguments": [
{
"name": "teamID",
"value": "06269010-2d8e-48e4-8f0e-33580720c9e1, 06bba22c-775e-42d8-b451-4221af061af0, 182f68db-6513-4e79-9ec2-a7e89a460e7f"
}
]
}
Beispiel 5: Aktivieren eines Benutzerkontos
{
"category": "joiner,leaver",
"description": "Enable user account",
"displayName": "EnableUserAccount",
"isEnabled": true,
"continueOnError": true,
"taskDefinitionId": "6fc52c9d-398b-4305-9763-15f42c1676fc",
"arguments": []
}
Beispiel 6: Ausführen einer benutzerdefinierten Aufgabenerweiterung
{
"category": "joiner,leaver",
"description": "Run a Custom Task Extension to call-out to an external system.",
"displayName": "Run a Custom Task Extension",
"isEnabled": true,
"continueOnError": true,
"taskDefinitionId": "d79d1fcc-16be-490c-a865-f4533b1639ee",
"arguments": [
{
"name": "customTaskExtensionID",
"value": "<ID of your Custom Task Extension>"
}
]
}
Beispiel 7: Deaktivieren eines Benutzerkontos
{
"category": "joiner,leaver",
"description": "Disable user account",
"displayName": "DisableUserAccount",
"isEnabled": true,
"continueOnError": true,
"taskDefinitionId": "1dfdfcc7-52fa-4c2e-bf3a-e3919cc12950",
"arguments": []
}
Beispiel 8: Entfernen eines Benutzers aus ausgewählten Gruppen
{
"category": "leaver",
"displayName": "Remove user from selected groups",
"description": "Remove user from membership of selected Azure AD groups",
"isEnabled": true,
"continueOnError": true,
"taskDefinitionId": "1953a66c-751c-45e5-8bfe-01462c70da3c",
"arguments": [
{
"name": "groupID",
"value": "06269010-2d8e-48e4-8f0e-33580720c9e1, 06bba22c-775e-42d8-b451-4221af061af0, 182f68db-6513-4e79-9ec2-a7e89a460e7f"
}
]
}
Beispiel 9: Entfernen eines Benutzers aus allen Gruppen
{
"category": "leaver",
"continueOnError": true,
"displayName": "Remove user from all groups",
"description": "Remove user from all Azure AD groups memberships",
"isEnabled": true,
"taskDefinitionId": "b3a31406-2a15-4c9a-b25b-a658fa5f07fc",
"arguments": []
}
Beispiel 10: Entfernen eines Benutzers aus ausgewählten Teams
{
"category": "joiner,leaver",
"continueOnError": true,
"displayName": "Remove user from selected Teams",
"description": "Remove user from membership of selected Teams",
"isEnabled": true,
"taskDefinitionId": "06aa7acb-01af-4824-8899-b14e5ed788d6",
"arguments": [
{
"name": "teamID",
"value": "TeamId1, TeamId2, TeamId3, ..."
}
]
}
Beispiel 11: Entfernen eines Benutzers aus allen Teams
{
"category": "leaver",
"continueOnError": true,
"description": "Remove user from all Teams",
"displayName": "Remove user from all Teams memberships",
"isEnabled": true,
"taskDefinitionId": "81f7b200-2816-4b3b-8c5d-dc556f07b024",
"arguments": []
}
Beispiel 12: Entfernen aller Lizenzzuweisungen von einem Benutzer
{
"category": "leaver",
"continueOnError": true,
"displayName": "Remove all licenses for user",
"description": "Remove all licenses assigned to the user",
"isEnabled": true,
"taskDefinitionId": "8fa97d28-3e52-4985-b3a9-a1126f9b8b4e",
"arguments": []
}
Beispiel 13: Löschen eines Benutzers
{
"category": "leaver",
"continueOnError": true,
"displayName": "Delete user account",
"description": "Delete user account in Azure AD",
"isEnabled": true,
"taskDefinitionId": "8d18588d-9ad3-4c0f-99d0-ec215f0e3dff",
"arguments": []
}
Beispiel 14: Senden einer E-Mail, um einen Vorgesetzten über eine Benutzerverschiebung zu benachrichtigen
{
"category": "mover",
"continueOnError": false,
"description": "Send email to notify user\u2019s manager of user move",
"displayName": "Send email to notify manager of user move",
"isEnabled": true,
"taskDefinitionId": "aab41899-9972-422a-9d97-f626014578b7",
"arguments": [
{
"name": "cc",
"value": "ac17d108-60cd-4eb2-a4b4-084cacda33f2,7d3ee937-edcc-46b0-9e2c-f832e01231ea"
},
{
"name": "customSubject",
"value": "{{userDisplayName}} has moved"
},
{
"name": "customBody",
"value": "Hello {{managerDisplayName}}\n\nwe are reaching out to let you know {{userDisplayName}} has moved in the organization.\n\nRegards\nYour IT department"
},
{
"name": "locale",
"value": "en-us"
}
]
}
Beispiel 15: Senden einer E-Mail an einen Vorgesetzten vor dem letzten Tag eines Benutzers
{
"category": "leaver",
"continueOnError": false,
"description": "Send offboarding email to user's manager before the last day of work",
"displayName": "Send email before user's last day",
"isEnabled": true,
"taskDefinitionId": "52853a3e-f4e5-4eb8-bb24-1ac09a1da935",
"arguments": [
{
"name": "cc",
"value": "068fa0c1-fa00-4f4f-8411-e968d921c3e7,e94ad2cd-d590-4b39-8e46-bb4f8e293f85"
},
{
"name": "customSubject",
"value": "Reminder that {{userDisplayName}}'s last day is coming up"
},
{
"name": "customBody",
"value": "Hello {{managerDisplayName}}\n\nthis is a reminder that {{userDisplayName}}'s last day is coming up.\n\nRegards\nYour IT department"
},
{
"name": "locale",
"value": "en-us"
}
]
}
Beispiel 16: Senden einer E-Mail am letzten Tag eines Benutzers
{
"category": "leaver",
"continueOnError": false,
"description": "Send offboarding email to user's manager on the last day of work",
"displayName": "Send email on user's last day",
"isEnabled": true,
"taskDefinitionId": "9c0a1eaf-5bda-4392-9d9e-6e155bb57411",
"arguments": [
{
"name": "cc",
"value": "068fa0c1-fa00-4f4f-8411-e968d921c3e7,e94ad2cd-d590-4b39-8e46-bb4f8e293f85"
},
{
"name": "customSubject",
"value": "{{userDisplayName}}'s last day"
},
{
"name": "customBody",
"value": "Hello {{managerDisplayName}}\n\nthis is a reminder that {{userDisplayName}}'s last day is today and their access will be revoked.\n\nRegards\nYour IT department"
},
{
"name": "locale",
"value": "en-us"
}
]
}
Beispiel 17: Senden der Offboarding-E-Mail an den Vorgesetzten eines Benutzers nach dem letzten Arbeitstag des Benutzers
{
"category": "leaver",
"continueOnError": true,
"displayName": "Send offboarding email to user's manager after the last day of work",
"description": "Send email after user's last day",
"isEnabled": true,
"continueOnError": true,
"taskDefinitionId": "6f22ddd4-b3a5-47a4-a846-0d7c201a49ce",
"arguments": []
}
Beispiel 18: Anfordern der Zuweisung von Benutzerzugriffspaketen
{
"category": "joiner,mover",
"continueOnError": false,
"description": "Request user assignment to selected access package",
"displayName": "Request user access package assignment",
"isEnabled": true,
"taskDefinitionId": "c1ec1e76-f374-4375-aaa6-0bb6bd4c60be",
"arguments": [
{
"name": "assignmentPolicyId",
"value": "00d6fd25-6695-4f4a-8186-e4c6f901d2c1"
},
{
"name": "accessPackageId",
"value": "2ae5d6e5-6cbe-4710-82f2-09ef6ffff0d0"
}
]
}
Beispiel 19: Entfernen der Zugriffspaketzuweisung für einen Benutzer
{
"category": "leaver,mover",
"continueOnError": false,
"description": "Remove user assignment of selected access package",
"displayName": "Remove access package assignment for user",
"isEnabled": true,
"taskDefinitionId": "4a0b64f2-c7ec-46ba-b117-18f262946c50",
"arguments": [
{
"name": "accessPackageId",
"value": "2ae5d6e5-6cbe-4710-82f2-09ef6ffff0d0"
}
]
}
Beispiel 20: Entfernen aller Zugriffspaketzuweisungen für einen Benutzer
{
"category": "leaver",
"continueOnError": false,
"description": "Remove all access packages assigned to the user",
"displayName": "Remove all access package assignments for user",
"isEnabled": true,
"taskDefinitionId": "42ae2956-193d-4f39-be06-691b8ac4fa1d",
"arguments": []
}
Beispiel 21: Abbrechen ausstehender Zugriffspaketzuweisungsanforderungen für einen Benutzer
{
"category": "leaver",
"continueOnError": false,
"description": "Cancel all access package assignment requests pending for the user",
"displayName": "Cancel all pending access package assignment requests for user",
"isEnabled": true,
"taskDefinitionId": "498770d9-bab7-4e4c-b73d-5ded82a1d0b3",
"arguments": []
}
Beispiel 22: Senden einer Erinnerungs-E-Mail für das Onboarding
{
"category": "joiner",
"continueOnError": false,
"description": "Send onboarding reminder email to user\u2019s manager",
"displayName": "Send onboarding reminder email",
"isEnabled": true,
"taskDefinitionId": "3C860712-2D37-42A4-928F-5C93935D26A1",
"arguments": [
{
"name": "cc",
"value": "e94ad2cd-d590-4b39-8e46-bb4f8e293f85,068fa0c1-fa00-4f4f-8411-e968d921c3e7"
},
{
"name": "customSubject",
"value": "Reminder: {{userDisplayName}} is starting soon"
},
{
"name": "customBody",
"value": "Hello {{managerDisplayName}}\n\nthis is a reminder that {{userDisplayName}} is starting soon.\n\nRegards\nYour IT department"
},
{
"name": "locale",
"value": "en-us"
}
]
}