Microsoft Intune

במאמר הזה מוסבר איך לשלב את Microsoft Intune עם Google Security Operations‏ (Google SecOps).

הגדרת שילוב של Microsoft Intune עם Google Security Operations

כדי להגדיר את מופע Microsoft Intune, צריך לבצע את השלבים הבאים.

שלבים מקדימים

כדי להשתמש בשילוב הזה, נדרשת אפליקציית Azure Active Directory ‏ (Azure AD).

הגדרה של Azure Active Directory

  1. נכנסים לפורטל הדייר (tenant) של Azure בתור משתמש עם הרשאות אדמין.
  2. עוברים אל Azure Active Directory > App registrations > New registration.
  3. בטופס הרישום, בוחרים שם לאפליקציה ולסוגי החשבונות הנתמכים בהתאם לסביבה.
  4. לוחצים על הרשמה.

הגדרת הרשאות לאפליקציה ב-Azure AD

  1. עוברים לכרטיסייה 'הרשאות API'.
  2. לוחצים על הוספת הרשאה.
  3. בחלון חדש, בוחרים באפשרות Microsoft Graph > הרשאות לאפליקציה.
  4. כדי להקל על החיפוש, בשדה החיפוש שמתחת לבחירת הרשאות מקלידים managed.
  5. בכרטיסייה DeviceManagementManagedDevices, בוחרים את ההרשאות הבאות:
    1. DeviceManagementManagedDevices.PrivilegedOperations.All\
    2. DeviceManagementManagedDevices.ReadWrite.All
  6. מאשרים את השינויים החדשים בהרשאות האדמין.

יצירת סוד לקוח לאפליקציית Azure AD

  1. עוברים אל Certificates and Secrets.
  2. בכרטיסייה Client secrets, לוחצים על New client secret.
  3. מוסיפים את התיאורים הנדרשים לסוד החדש.
    אחרי שמוסיפים את הסוד, רואים את הנתונים שלו.
  4. כדי להשתמש בסוד בשילוב, רושמים את הערך של סוד הלקוח.

השלמת ההגדרה

  1. בדף ההגדרה של אפליקציית Azure AD, עוברים לכרטיסייה Essentials.
  2. מזינים את מזהה האפליקציה (הלקוח) ואת מזהה הספרייה (הדייר) מהשלבים הקודמים.

אחרי איסוף הנתונים, ההגדרה של אפליקציית Azure AD לשילוב עם Microsoft Intune הושלמה.

הגדרת שילוב של Microsoft Intune ב-Google SecOps

פרמטרים של שילוב

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
נקודת קצה של Azure AD String https://login.microsoftonline.com נכון נקודת הקצה של Azure AD להתחברות אליה.
יכולה להיות שונה לסוגים שונים של דיירים.
נקודת קצה של Microsoft Graph String https://graph.microsoft.com נכון נקודת קצה של Microsoft Graph להתחברות אליה.
יכולה להיות שונה לסוגים שונים של דיירים.
מזהה לקוח String לא רלוונטי נכון מציינים את מזהה הלקוח (האפליקציה) של אפליקציית Azure AD
שבה רוצים להשתמש לשילוב.
ערך סוד הלקוח סיסמה לא רלוונטי נכון מציינים את הערך של סוד הלקוח (לא מזהה הסוד!) של אפליקציית Azure AD
שבה רוצים להשתמש לשילוב.
מזהה Azure Active Directory String לא רלוונטי נכון מציינים את המזהה של Azure Active Directory (מזהה הדייר).
כדי למצוא אותו, עוברים לדף Azure AD > רישום אפליקציות >
Application you configured for your integration >
מזהה ספרייה (דייר).
אימות SSL bool סימן אישור לא רלוונטי אם האפשרות הזו מופעלת, צריך לוודא שאישור ה-SSL לחיבור
לשרת Microsoft Intune תקף.

פעולות

פינג

תיאור

בודקים את הקישוריות.

פרמטרים

לא רלוונטי

הפעלה ב-

הפעולה לא מופעלת בישויות.

תוצאות הפעולה

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False

אם הפעולה תפעל בהצלחה, הערך של is_success יהיה True. אחרת, False.

Case wall
סוג התוצאות ערך/תיאור סוג (ישות/כללי)
הודעת פלט* הפעולה לא אמורה להיכשל או להפסיק את ההרצה של ה-Playbook:
אם הפעולה הצליחה:
print "Successfully connected to the Microsoft Intune service with the provided connection parameters!"

הפעולה אמורה להיכשל ולהפסיק את ההרצה של ה-Playbook:
אם יש שגיאה קריטית, כמו פרטי כניסה שגויים או אובדן קישוריות:
print "Failed to connect to the Microsoft Intune service! Error is {0}".format(exception.stacktrace) 		כללי

רשימת מכשירים מנוהלים

תיאור

רשימת המכשירים המנוהלים שזמינים במופע Microsoft Intune על סמך הקריטריונים שצוינו.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
מפתח המסנן DDL בוחרים באחת מהאפשרויות

ערכים אפשריים של DDL:
  • deviceName
  • userId
  • operatingSystem
  • osVersion
  • userDisplayName
 לא נכון מציינים את המפתח שבו רוצים להשתמש כדי לסנן מכשירים מנוהלים.
לוגיקת הסינון DDL לא צוין

ערכים אפשריים של DDL:
  • לא צוינה
  • שווה
  • מכיל
לא נכון מציינים את לוגיקת הסינון שרוצים להחיל.
לוגיקת הסינון פועלת על סמך הערך שצוין בפרמטר Filter Key.
ערך המסנן String לא רלוונטי לא נכון מציינים באיזה ערך להשתמש במסנן.
אם נבחרה האפשרות Equal, הפעולה תנסה למצוא התאמה מדויקת בין התוצאות. אם נבחרה האפשרות Contains, הפעולה תנסה למצוא תוצאות שמכילות את מחרוזת המשנה הזו.
אם לא מציינים ערך בפרמטר הזה, המסנן לא יופעל.
לוגיקת הסינון פועלת על סמך הערך שמוגדר בפרמטר Filter Key.
מספר הרשומות המקסימלי שיוחזר Int 50 לא נכון מציינים כמה רשומות להחזיר.
אם לא מציינים כלום, הפעולה תחזיר 50 רשומות כברירת מחדל.
הערך המקסימלי הוא 100 רשומות.

הפעלה ב-

הפעולה לא מופעלת בישויות.

תוצאות הפעולה

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False

אם הפעולה מופעלת בהצלחה (הנתונים מוחזרים, תגובת השרת היא 200 OK), צריך להגדיר את is_success לערך True.

תוצאה בפורמט JSON
{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#deviceManagement/managedDevices",
  "@odata.count": 8,
  "value": [
      {
          "id": "a80a77c5-c26f-4def-b350-2b80ae9b5e00",
          "userId": "",
          "deviceName": "CROWDSTRIKEV2",
          "managedDeviceOwnerType": "personal",
          "enrolledDateTime": "2022-03-01T20:42:04Z",
          "lastSyncDateTime": "2022-03-04T04:42:03Z",
          "operatingSystem": "Windows",
          "complianceState": "noncompliant",
          "jailBroken": "Unknown",
          "managementAgent": "mdm",
          "osVersion": "10.0.19043.1526",
          "easActivated": false,
          "easDeviceId": "",
          "easActivationDateTime": "0001-01-01T00:00:00Z",
          "azureADRegistered": null,
          "deviceEnrollmentType": "windowsAutoEnrollment",
          "activationLockBypassCode": null,
          "emailAddress": "",
          "azureADDeviceId": "a80a77c5-c26f-4def-b350-2b80ae9b5e00",
          "deviceRegistrationState": "registered",
          "deviceCategoryDisplayName": "Unknown",
          "isSupervised": false,
          "exchangeLastSuccessfulSyncDateTime": "0001-01-01T00:00:00Z",
          "exchangeAccessState": "none",
          "exchangeAccessStateReason": "none",
          "remoteAssistanceSessionUrl": null,
          "remoteAssistanceSessionErrorDetails": null,
          "isEncrypted": false,
          "userPrincipalName": "",
          "model": "VMware7,1",
          "manufacturer": "VMware, Inc.",
          "imei": "",
          "complianceGracePeriodExpirationDateTime": "2022-10-16T16:36:51Z",
          "serialNumber": "VMware-422238ba4acad659-63a1867ec4889b06",
          "phoneNumber": "",
          "androidSecurityPatchLevel": "",
          "userDisplayName": "",
          "configurationManagerClientEnabledFeatures": null,
          "wiFiMacAddress": "",
          "deviceHealthAttestationState": null,
          "subscriberCarrier": "",
          "meid": "",
          "totalStorageSpaceInBytes": 63766003712,
          "freeStorageSpaceInBytes": 38917898240,
          "managedDeviceName": "",
          "partnerReportedThreatState": "unknown",
          "requireUserEnrollmentApproval": null,
          "managementCertificateExpirationDate": "2023-02-27T08:10:12Z",
          "iccid": null,
          "udid": null,
          "notes": null,
          "ethernetMacAddress": null,
          "physicalMemoryInBytes": 0,
          "deviceActionResults": []
      },
      ...
Case wall
סוג התוצאות ערך/תיאור סוג (ישות/כללי)
הודעת פלט* הפעולה לא אמורה להיכשל או להפסיק את ההרצה של פלייבוק:
אם הנתונים זמינים(is_success = true):
print "Successfully found managed device(s) for the provided criteria in the Microsoft Intune instance".​

אם הנתונים לא זמינים (is_success=false):
print "No managed devices were found for the provided criteria in the Microsoft Intune instance".

אם הערך של 'ערך המסנן' ריק (is_success=true):
המסנן לא הוחל כי הפרמטר 'ערך המסנן' ריק.

הפעולה תיכשל ותפסיק את ההפעלה של ה-Playbook:

אם Filter Key == "Select One" ו-Filter Logic "Equal" או "Contains":
שגיאה בהפעלת הפעולה List Managed Devices. הסיבה: צריך לבחור שדה מהפרמטר Filter Key.

If invalid value is provided for Max Records to Return or the value is bigger than 100:
Error executing the List Managed Devices action. הסיבה: "צוין ערך לא חוקי עבור 'מספר הרשומות המקסימלי להחזרה': <הערך שצוין>. צריך לציין מספר חיובי בטווח שבין 1 ל-100".
​
אם מדובר בשגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת:
"Error executing the List Managed Devices action. הסיבה: {0}''.format(error.Stacktrace)		 כללי
טבלה של Case Wall

 שם: מכשירים מנוהלים זמינים
עמודות:
  • מזהה
  • מזהה משתמש
  • שם המכשיר
  • מערכת הפעלה
  • מצב תאימות
  • תאריך ושעת ההרשמה
  • תאריך ושעה של הסנכרון האחרון
 כללי

קבלת מכשיר מנוהל

תיאור

קבלת מידע על מכשירים מנוהלים משירות Microsoft Intune, כולל מידע על פעולות ספציפיות, למשל איתור מכשיר (deviceActionResults בקטע של תוצאת ה-JSON).
אפשר לספק את שם המארח להרצת הפעולה כיישות של Google SecOps או כפרמטר קלט של הפעולה. אם שם המארח מועבר לפעולה גם כיישות וגם כפרמטר קלט, הפעולה תופעל על פרמטר הקלט. שם המארח לא תלוי באותיות רישיות. אפשר גם לספק לפעולה את מזהה המארח להרצה.
אם מספקים גם את מזהה המארח וגם את שם המארח, הפעולה תופעל על מזהה המארח כברירת מחדל.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
שם המארח String לא רלוונטי לא נכון מציינים את שם המארח שבו רוצים להריץ את הפעולה. שם המארח לא תלוי-רישיות. אם הפעולה לא מופעלת בישות Hostname, היא יכולה לפעול ב-Hostname או ב-Host ID. אפשר להגדיר כמה ערכים כמחרוזת מופרדת בפסיקים.
מזהה המארח String לא רלוונטי לא נכון מציינים את מזהה המארח שבו רוצים להפעיל את הפעולה. אם הפעולה לא מופעלת בישות Hostname, היא יכולה לפעול ב-Hostname או ב-Host ID. אפשר להגדיר כמה ערכים כמחרוזת מופרדת בפסיקים.

הפעלה ב-

שם המארח, אם סופק.

תוצאות הפעולה

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False

אם הפעולה מופעלת בהצלחה (המארח נמצא, תגובת השרת היא 200 OK), הערך של is_success צריך להיות True.

תוצאה בפורמט JSON
{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#deviceManagement/managedDevices/$entity",
  "id": "6caa05f6-563d-4a47-bcd8-e91c5dbab10a",
  "userId": "b786d3cf-e97d-4511-b61c-0559e9f4da75",
  "deviceName": "msintune2",
  "managedDeviceOwnerType": "company",
  "enrolledDateTime": "2023-05-11T09:45:08.6273921Z",
  "lastSyncDateTime": "2023-05-17T06:41:23.6481049Z",
  "operatingSystem": "Windows",
  "complianceState": "compliant",
  "jailBroken": "Unknown",
  "managementAgent": "mdm",
  "osVersion": "10.0.19045.2965",
  "easActivated": false,
  "easDeviceId": null,
  "easActivationDateTime": "0001-01-01T00:00:00Z",
  "azureADRegistered": true,
  "deviceEnrollmentType": "windowsAzureADJoin",
  "activationLockBypassCode": null,
  "emailAddress": "example@example.com",
  "azureADDeviceId": "a5fe5437-cc0e-4ecf-9216-5d60032d149d",
  "deviceRegistrationState": "registered",
  "deviceCategoryDisplayName": "",
  "isSupervised": false,
  "exchangeLastSuccessfulSyncDateTime": "0001-01-01T00:00:00Z",
  "exchangeAccessState": "none",
  "exchangeAccessStateReason": "none",
  "remoteAssistanceSessionUrl": "",
  "remoteAssistanceSessionErrorDetails": "",
  "isEncrypted": false,
  "userPrincipalName": "example@example.com",
  "model": "VMware7,1",
  "manufacturer": "VMware, Inc.",
  "imei": null,
  "complianceGracePeriodExpirationDateTime": "9999-12-31T23:59:59.9999999Z",
  "serialNumber": "VMware-42366cbe5a53838a-d95202d5e9a468c5",
  "phoneNumber": null,
  "androidSecurityPatchLevel": null,
  "userDisplayName": "example_user",
  "configurationManagerClientEnabledFeatures": null,
  "wiFiMacAddress": null,
  "deviceHealthAttestationState": null,
  "subscriberCarrier": "",
  "meid": null,
  "totalStorageSpaceInBytes": 52998176768,
  "freeStorageSpaceInBytes": 27044872192,
  "managedDeviceName": "example_Windows_5/11/2023_11:43 AM",
  "partnerReportedThreatState": "unknown",
  "requireUserEnrollmentApproval": null,
  "managementCertificateExpirationDate": "2024-05-10T00:50:50Z",
  "iccid": "",
  "udid": "",
  "notes": null,
  "ethernetMacAddress": "005056B6FD6F",
  "physicalMemoryInBytes": 0,
  "deviceActionResults": [
      {
          "@odata.type": "#microsoft.graph.locateDeviceActionResult",
          "actionName": "locateDevice",
          "actionState": "pending",
          "startDateTime": "2023-05-17T12:36:50.1982608Z",
          "lastUpdatedDateTime": "2023-05-17T12:36:50Z",
          "deviceLocation": null
      }
  ]
}
Case wall
סוג התוצאות ערך/תיאור סוג (ישות/כללי)
הודעת פלט* הפעולה לא תיכשל ולא תפסיק את ההרצה של ה-Playbook:

אם נמצא מארח(is_success = true):
שם המארח שסופק:
print "Successfully fetched managed device information for hostname: <hosntame>"
מזהה המארח שסופק:
print "Successfully fetched managed device information for host id: <host id>"
​
אם הנתונים לא זמינים (is_success=false)
שם המארח שסופק:
print "The following hostname was not found in the Microsoft Intune: <hostname>"
מזהה המארח שסופק:
print "The following host id was not found in the Microsoft Intune: <host id>"
​
אם מוחזרים כמה סוכני Intune עבור שם המארח:
print "Multiple managed devices were found for the provided hostname: <hostname>. Taking the managed device with the most recent lastSyncDateTime"

הפעולה תיכשל ותפסיק את ההרצה של ה-Playbook:

אם יש שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת, או שגיאה אחרת:
"Error executing action "Get Managed Device". Reason: {0}''.format(error.Stacktrace)		 כללי

סנכרון מכשיר מנוהל

תיאור

סנכרון מכשיר מנוהל עם שירות Microsoft Intune. אפשר לספק את שם המארח שעליו רוצים להריץ את הפעולה כיישות של Google SecOps או כפרמטר קלט של הפעולה. אם שם המארח מועבר לפעולה גם כיישות וגם כפרמטר קלט, הפעולה תבוצע על פרמטר הקלט. שם המארח לא תלוי-רישיות. אפשר גם לספק את המזהה של המארח כדי להפעיל את הפעולה.
אם מציינים גם את מזהה המארח וגם את שם המארח, הפעולה תופעל קודם על מזהה המארח.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
שם המארח CSV לא רלוונטי לא נכון מציינים רשימה של שמות מארחים שמופרדים בפסיקים כדי להפעיל את הפעולה. שם המארח לא תלוי באותיות רישיות. אם הפעולה לא מופעלת על ישות של שם מארח, היא יכולה לפעול על שם מארח או על מזהה מארח. הערה: אם מציינים גם שם מארח וגם מזהה מארח, הערך של מזהה המארח מקבל עדיפות. אפשר להגדיר כמה ערכים כמחרוזת שמופרדת בפסיקים.
מזהה המארח CSV לא רלוונטי לא נכון מציינים רשימה של מזהי מארחים שמופרדים בפסיקים, שעליהם תופעל הפעולה. אם הפעולה לא מופעלת בישות של שם מארח, היא יכולה לפעול בשם מארח או במזהה מארח. הערה: אם מציינים גם שם מארח וגם מזהה מארח, הערך של מזהה המארח מקבל עדיפות. אפשר להגדיר כמה ערכים כמחרוזת מופרדת בפסיקים.

הפעלה ב-

שם המארח, אם סופק.

תוצאות הפעולה

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False

אם הפעולה מתבצעת בהצלחה (המארח נמצא, תגובת השרת היא 204), הערך של is_success צריך להיות True.

Case wall
סוג התוצאות ערך/תיאור סוג (ישות/כללי)
הודעת פלט* הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של ספר ההפעלה:

אם נמצא לפחות מארח אחד (is_success = true, אם נמצאו כל המארחים בהיקף ההתראה, אחרת is_success=false):
שם המארח שסופק:
print "Successfully started sync for managed devices with hostnames in the Microsoft Intune: CSV of <hosntame>"
מזהה המארח שסופק:
print "Successfully started sync for managed devices with host ids in the Microsoft Intune: CSV of <host id>"

אם לפחות מארח אחד לא זמין (is_success=false)
שם המארח שסופק:
print "The following hostnames were not found in the Microsoft Intune: CSV of <hostname>"
מזהה המארח שסופק:
print "The following host ids were not found in the Microsoft Intune: CSV of <host ids>"
​
אם הוחזרו כמה סוכני Intune עבור שם המארח (is_success = true):
print "Multiple managed devices were found for the provided hostnames in the Microsoft Intune: <hostnames>. Taking the managed device with the most recent lastSyncDateTime"
​
אם לא נמצאו אף אחד משמות המארחים או המארחים, או אם קוד הסטטוס הוא 400 לכולם (is_success=false):
No tasks were created on the provided hosts in Microsoft Intune.
​
הפעולה אמורה להיכשל ולהפסיק את ההרצה של ה-Playbook:

אם מדובר בשגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת, או שגיאה אחרת:
"Error executing action "Sync Managed Device". Reason: {0}''.format(error.Stacktrace)
​
If entity is not provided and input is also not provided (is_success=false):
Error executing action "Sync Managed Device". הסיבה: הפעולה לא התחילה כי שם המארח או מזהה המארח לא סופקו כרכיב Google SecOps או כפרמטר קלט של הפעולה.		 כללי

איתור מכשיר מנוהל

תיאור

מאתרים את המכשיר המנוהל באמצעות שירות Microsoft Intune. הפעולה מתחילה את המשימה לבדיקת הסטטוס הנוכחי של המשימה, מפעילה את הפעולה Get Managed Device ומציגה את הסטטוס של המשימה בקטע deviceActionResults.
אפשר לספק את שם המארח להפעלת הפעולה כיישות Google SecOps או כפרמטר קלט של הפעולה.
אם שם המארח מועבר לפעולה גם כיישות וגם כפרמטר קלט, הפעולה תופעל על פרמטר הקלט. שם המארח לא תלוי באותיות רישיות. אפשר גם לספק לפעולה את מזהה המארח להפעלה.
אם מספקים גם את מזהה המארח וגם את שם המארח, הפעולה תופעל על מזהה המארח כעדיפות.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
שם המארח String לא רלוונטי לא נכון מציינים רשימה של שמות מארחים שמופרדים בפסיקים כדי להפעיל את הפעולה. שם המארח לא תלוי באותיות רישיות. אם הפעולה לא מופעלת על ישות של שם מארח, היא יכולה לפעול על שם מארח או על מזהה מארח. הערה: אם מציינים גם שם מארח וגם מזהה מארח, הערך של מזהה המארח מקבל עדיפות. אפשר להגדיר כמה ערכים כמחרוזת שמופרדת בפסיקים.
מזהה המארח String לא רלוונטי לא נכון מציינים רשימה של מזהי מארחים שמופרדים בפסיקים, שעליהם תופעל הפעולה. אם הפעולה לא מופעלת בישות של שם מארח, היא יכולה לפעול בשם מארח או במזהה מארח. הערה: אם מציינים גם שם מארח וגם מזהה מארח, הערך של מזהה המארח מקבל עדיפות. אפשר להגדיר כמה ערכים כמחרוזת מופרדת בפסיקים.

הפעלה ב-

שם המארח, אם סופק.

תוצאות הפעולה

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False

אם הפעולה מתבצעת בהצלחה (המארח נמצא, תגובת השרת היא 204), הערך של is_success צריך להיות True.

Case wall
סוג התוצאות ערך/תיאור סוג (ישות/כללי)
הודעת פלט* הפעולה לא אמורה להיכשל או להפסיק את ההרצה של ספריית הפעולות:

אם נמצא לפחות מארח אחד(is_success = true, אם כל המארחים בהיקף ההתראה נמצאו, אחרת is_success=false):
שם המארח שסופק:
print "Successfully started locate task for managed devices with hostnames in the Microsoft Intune: CSV of <hosntame>"
מזהה המארח שסופק:
print "Successfully started locate task for managed devices with host ids in the Microsoft Intune: CSV of <host id>"

אם לפחות מארח אחד לא זמין (is_success=false)
שם המארח שסופק:
print "The following hostnames were not found in the Microsoft Intune: CSV of <hostname>"
מזהה המארח שסופק:
print "The following host ids were not found in the Microsoft Intune: CSV of <host ids>"

אם הוחזרו כמה סוכני Intune עבור שם המארח (is_success = true):
print "Multiple managed devices were found for the provided hostnames in the Microsoft Intune: <hostnames>. Taking the managed device with the most recent lastSyncDateTime"

אם קוד הסטטוס הוא 400:
Action wasn't able to create a task for the following hosts in the Microsoft Intune: {hostname/hostids}
​
אם אף אחד משמות המארחים או המארחים לא נמצא או אם קוד הסטטוס הוא 400 לכולם (is_success=false:
No tasks were created on the provided hosts in Microsoft Intune.
​
הפעולה אמורה להיכשל ולהפסיק את ההרצה של ספריית הפעולות:

אם יש שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת, או שגיאה אחרת:
"Error executing action "Locate Managed Device". Reason: {0}''.format(error.Stacktrace)
​
אם לא סופק ישות ולא סופק קלט (is_success=false):
Error executing action "Locate Managed Device". Reason: Action failed to start since Hostname or Host ID was not provided either as Google SecOps entity or action input parameter.
 כללי

איפוס נתונים במכשיר מנוהל

תיאור

מחיקת נתונים ממכשיר מנוהל באמצעות שירות Microsoft Intune.
אפשר לספק את שם המארח להפעלת הפעולה כיישות של Google SecOps או כפרמטר קלט של הפעולה. אם שם המארח מועבר לפעולה גם כיישות וגם כפרמטר קלט, הפעולה תופעל על פרמטר הקלט.
שם המארח לא תלוי באותיות רישיות. אפשר גם לספק לפעולה את מזהה המארח להפעלה.
אם מספקים גם את מזהה המארח וגם את שם המארח, הפעולה תופעל על מזהה המארח כעדיפות.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
שם המארח String לא רלוונטי לא נכון מציינים רשימה של שמות מארחים מופרדים בפסיקים להפעלת הפעולה. שם המארח לא תלוי באותיות רישיות. אם הפעולה לא מופעלת על ישות של שם מארח, היא יכולה לפעול על שם מארח או על מזהה מארח. הערה: אם מציינים גם שם מארח וגם מזהה מארח, הערך של מזהה המארח מקבל עדיפות. אפשר לציין כמה ערכים כמחרוזת מופרדת בפסיקים.
מזהה המארח String לא רלוונטי לא נכון מציינים רשימה של שמות מארחים מופרדים בפסיקים להפעלת הפעולה. שם המארח לא תלוי באותיות רישיות. אם הפעולה לא מופעלת על ישות של שם מארח, היא יכולה לפעול על שם מארח או על מזהה מארח. הערה: אם מציינים גם שם מארח וגם מזהה מארח, הערך של מזהה המארח מקבל עדיפות. אפשר לציין כמה ערכים כמחרוזת מופרדת בפסיקים.
שמירת נתוני ההרשמה תיבת סימון תיבת סימון לא מסומנת לא נכון אם האפשרות הזו מופעלת, נתוני ההרשמה נשמרים במכשיר.
שמירת נתוני המשתמשים תיבת סימון תיבת סימון לא מסומנת לא נכון אם ההגדרה מופעלת, נתוני המשתמש נשמרים במכשיר.
שמירת חבילת הגלישה של ה-eSIM תיבת סימון תיבת סימון לא מסומנת לא נכון אם ההגדרה הזו מופעלת, חבילת הגלישה של ה-eSIM נשמרת במכשיר.
קוד ביטול הנעילה ב-Mac OS String לא רלוונטי לא נכון אם רלוונטי, מציינים את קוד ביטול הנעילה של Mac OS.

הפעלה ב-

שם המארח, אם סופק.

תוצאות הפעולה

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False

אם הפעולה מתבצעת בהצלחה (המארח נמצא, תגובת השרת היא 204), הערך של is_success צריך להיות True.

Case wall
סוג התוצאות ערך/תיאור סוג (ישות/כללי)
הודעת פלט* הפעולה לא אמורה להיכשל או להפסיק את ההרצה של Playbook:

אם נמצא לפחות מארח אחד (is_success = true, אם נמצאו כל המארחים בהיקף ההתראה, אחרת is_success=false):
שם המארח שסופק:
print "Successfully started wipe task for managed devices with hostnames in the Microsoft Intune: CSV of <hosntame>"
מזהה המארח שסופק:
print "Successfully started wipe task for managed devices with host ids in the Microsoft Intune: CSV of <host id>"
​
אם לפחות מארח אחד לא זמין (is_success=false)
שם המארח שסופק:
print "The following hostnames were not found in the Microsoft Intune: CSV of <hostname>"
מזהה המארח שסופק:
print "The following host ids were not found in the Microsoft Intune: CSV of <host ids>"
​
אם הוחזרו כמה סוכני Intune עבור שם המארח (is_success = true):
print "Multiple managed devices were found for the provided hostnames in the Microsoft Intune: <hostnames>. Taking the managed device with the most recent lastSyncDateTime"

אם לא נמצאו שמות מארחים או מארחים, או אם קוד הסטטוס הוא 400 לכולם (is_success=false):
No tasks were created on the provided hosts in Microsoft Intune.

הפעולה אמורה להיכשל ולהפסיק את ההרצה של Playbook:

אם יש שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת או שגיאה אחרת:
"Error executing action "Wipe Managed Device". Reason: {0}''.format(error.Stacktrace)

אם לא סופק ישות ולא סופק קלט (is_success=false):
Error executing action "Wipe Managed Device". Reason: Action failed to start since Hostname or Host ID was not provided either as Google SecOps entity or action input parameter.		 כללי

איפוס קוד הגישה של מכשיר מנוהל

תיאור

איפוס קוד הגישה של מכשיר מנוהל. הפעולה מתחילה את המשימה לבדיקת הסטטוס הנוכחי של המשימה, מפעילה את הפעולה Get Managed Device ומציגה את הקטע deviceActionResults עם סטטוס המשימה.
אפשר לספק את שם המארח להרצת הפעולה כיישות של Google SecOps או כפרמטר קלט של פעולה. אם שם המארח מועבר לפעולה גם כיישות וגם כפרמטר קלט, הפעולה תבוצע על פרמטר הקלט.
שם המארח לא תלוי-רישיות. אפשר גם לספק את המזהה של המארח כדי להפעיל את הפעולה.
אם צוינו גם מזהה המארח וגם שם המארח, הפעולה תופעל על מזהה המארח כברירת מחדל.

פרמטרים

שם הפרמטר סוג ערך ברירת המחדל חובה תיאור
שם המארח String לא רלוונטי לא נכון מציינים רשימה של שמות מארחים שמופרדים בפסיקים כדי להפעיל את הפעולה. שם המארח הוא לא תלוי-רישיות. אם הפעולה לא מופעלת על ישות של שם מארח, היא יכולה לפעול על שם המארח או על מזהה המארח. הערה: אם מציינים גם שם מארח וגם מזהה מארח, הערך של מזהה המארח מקבל עדיפות. אפשר לציין כמה ערכים כמחרוזת שמופרדת בפסיקים.
מזהה המארח String לא רלוונטי לא נכון מציינים רשימה של שמות מארחים שמופרדים באמצעות פסיקים כדי להפעיל את הפעולה. אם הפעולה לא מופעלת בישות של שם מארח, היא יכולה לפעול בשם מארח או במזהה מארח. הערה: אם מציינים גם שם מארח וגם מזהה מארח, הערך של מזהה המארח מקבל עדיפות. אפשר לציין כמה ערכים כמחרוזת שמופרדת באמצעות פסיקים.

הפעלה ב-

שם המארח, אם סופק.

תוצאות הפעולה

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False

אם הפעולה מתבצעת בהצלחה (המארח נמצא, תגובת השרת היא 204), הערך של is_success צריך להיות True.

Case wall
סוג התוצאות ערך/תיאור סוג (ישות/כללי)
הודעת פלט* הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של ה-Playbook:

אם נמצא לפחות מארח אחד(is_success = true, אם נמצאו כל המארחים בהיקף ההתראה, אחרת is_success=false):
שם המארח שסופק:
print "Successfully started reset task for managed devices with hostnames in the Microsoft Intune: CSV of <hosntame>"
מזהה המארח שסופק:
print "Successfully started reset task for managed devices with host ids in the Microsoft Intune: CSV of <host id>"

אם לפחות מארח אחד לא זמין (is_success=false)
שם המארח שסופק:
print "The following hostnames were not found in the Microsoft Intune: CSV of <hostname>"
מזהה המארח שסופק:
print "The following host ids were not found in the Microsoft Intune: CSV of <host ids>"

אם הוחזרו כמה סוכני Intune עבור שם המארח (is_success = true):
print "Multiple managed devices were found for the provided hostnames in the Microsoft Intune: <hostnames>. Taking the managed device with the most recent lastSyncDateTime"


אם לא נמצאו שמות מארחים או מארחים, או אם קוד הסטטוס הוא 400 לכולם (is_success=false):
No tasks were created on the provided hosts in Microsoft Intune.
​
הפעולה אמורה להיכשל ולהפסיק את ההפעלה של playbook:

אם מדובר בשגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת, או שגיאה אחרת:
"Error executing action "Reset Managed Device Passcode". הסיבה: {0}''.format(error.Stacktrace)
​
שגיאה בהפעלת הפעולה 'איפוס מכשיר מנוהל'. הסיבה: הפעולה לא התחילה כי שם המארח או מזהה המארח לא סופקו כרכיב Google SecOps או כפרמטר קלט של הפעולה.
 כללי

נעילה מרחוק של מכשיר מנוהל

תיאור

נעילת המכשיר המנוהל מרחוק.
הפעולה מתחילה את המשימה לבדיקת הסטטוס הנוכחי של המשימה, מריצה את הפעולה Get Managed Device ומוצג הקטע deviceActionResults עם סטטוס המשימה. אפשר לספק את שם המארח להרצת הפעולה כיישות Google SecOps או כפרמטר קלט של הפעולה. אם שם המארח מועבר לפעולה גם כיישות וגם כפרמטר קלט, הפעולה תבוצע על פרמטר הקלט.
שם המארח לא תלוי-רישיות. אפשר גם לספק את המזהה של המארח כדי להפעיל את הפעולה. אם מציינים גם מזהה מארח וגם שם מארח, הפעולה תתבצע קודם על מזהה המארח.
הפעולה יכולה לפעול על ישות או על פרמטר קלט של פעולה.

פרמטרים

השם המוצג של הפרמטר סוג ערך ברירת המחדל חובה תיאור
שם המארח String לא רלוונטי לא נכון מציינים רשימה של שמות מארחים שמופרדים בפסיקים כדי להפעיל את הפעולה. שם המארח הוא לא תלוי-רישיות. אם הפעולה לא מופעלת על ישות של שם מארח, היא יכולה לפעול על שם המארח או על מזהה המארח. הערה: אם מציינים גם שם מארח וגם מזהה מארח, הערך של מזהה המארח מקבל עדיפות. אפשר לציין כמה ערכים כמחרוזת שמופרדת בפסיקים.
מזהה המארח String לא רלוונטי לא נכון מציינים רשימה של מזהי מארחים שמופרדים בפסיקים, שעליהם תופעל הפעולה. אם הפעולה לא מופעלת בישות של שם מארח, היא יכולה לפעול בשם המארח או במזהה המארח. הערה: אם מציינים גם שם מארח וגם מזהה מארח, הערך של מזהה המארח מקבל עדיפות. אפשר להזין כמה ערכים כמחרוזת שמופרדת בפסיקים.

הפעלה ב-

שם המארח, אם סופק.

תוצאות הפעולה

תוצאת סקריפט
שם התוצאה של הסקריפט אפשרויות ערך דוגמה
is_success נכון/לא נכון is_success:False

אם הפעולה מתבצעת בהצלחה (המארח נמצא, תגובת השרת היא 204), הערך של is_success צריך להיות True.

Case wall
סוג התוצאות ערך/תיאור סוג (ישות/כללי)
הודעת פלט* הפעולה לא אמורה להיכשל או להפסיק את ההפעלה של ספריית הפעולות:
​אם נמצא לפחות מארח אחד(is_success = true, אם נמצאו כל המארחים בהיקף ההתראה, אחרת is_success=false):
שם המארח שסופק:
print "Successfully started remote lock task for managed devices with hostnames in the Microsoft Intune: CSV of <hostname>"
מזהה המארח שסופק:
print "Successfully started remote lock task for managed devices with host ids in the Microsoft Intune: CSV of <host id>"

​אם לפחות מארח אחד לא זמין (is_success=false):
שם המארח שסופק:
print "The following hostnames were not found in the Microsoft Intune: CSV of <hostname>"
מזהה המארח שסופק:
print "The following host ids were not found in the Microsoft Intune: CSV of <host ids>"​
אם מוחזרים כמה סוכני Intune עבור שם המארח (is_success = true):
print "Multiple managed devices were found for the provided hostnames in the Microsoft Intune: <hostnames>. Taking the managed device with the most recent lastSyncDateTime"

אם לא נמצאו שמות מארחים או מארחים, או אם קוד הסטטוס הוא 400 לכולם (is_success=false):
No tasks were created on the provided hosts in Microsoft Intune.

​הפעולה אמורה להיכשל ולהפסיק את ההפעלה של ספריית הפעולות:
אם יש שגיאה חמורה, כמו פרטי כניסה שגויים, אין חיבור לשרת, או שגיאה אחרת:
"Error executing action "Reset Lock Managed Device". Reason: {0}''.format(error.Stacktrace)

​Error executing action "Reset Lock Managed Device". Reason: Action failed to start since Hostname or Host ID was not provided either as Google SecOps entity or action input parameter.		 כללי

הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.