הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
הערה
המאפיינים במאמר זה מופעלים על ידי הרתמה הסטנדרטית, המשתמשת באפשרויות החיוב המתוארות ברישוי לסוכנים המופעלים על ידי הרתמה הסטנדרטית. למד כיצד לגשת לתכונות סטנדרטיות בסוכנים ובזרימות הסוכנים הסטנדרטיים של Access (Consumer Flows).
חשוב
זוהי תכונת Preview.
- Microsoft תצוגה מקדימה לפני מהדורה רשמית כדי שלקוחות יוכלו לקבל גישה מוקדמת ולספק משוב.
- לתכונות תצוגה מקדימה יש פונקציונליות מוגבלת והן אינן מיועדות לשימוש ייצור.
- Microsoft עשויה לשנות את השמות והפרמטרים של כלי MCP בגרסת תצוגה מקדימה. הימנע מיתלות עם קוד קשיח. Microsoft שומרת על תמיכת תרחישים.
- תכונות התצוגה המקדימה כפופות Microsoft תנאי שימוש נוספים.
סקירה כללית
| מזהה שרת | כתובת URL ברמת הדייר | שם התצוגה | תיאור |
|---|---|---|---|
mcp_OneDriveRemoteServer |
https://agent365.svc.cloud.microsoft/agents/tenants/{tenantId}/servers/mcp_OneDriveRemoteServer |
OneDrive | כלים לתפעול OneDrive. השתמש בשרת זה לניהול קבצים ותיקיות בתיקיות האישיות של המשתמש OneDrive. כל פעולות הקובץ מוגבלות ל- ≤5MB. |
כלים זמינים
קבל אתOnedrive
מחזיר מידע על ה-OneDrive של המשתמש, כולל מטה-נתונים של הכונן, מכסה ופרטי הבעלים.
לא נדרשים פרמטרים.
קבל אתFolderChildrenInMyOnedrive
ספירת 20 הקבצים והתיקיות המובילים (DriveItems) הכלולים בתוך תיקיית אב שצוינה ברשימת הקבצים של OneDrive.
פרמטרים אופציונליים:
- parentFolderId: מזהה תיקיית האב שאת הקבצים והתיקיות שלה ברצונך להוסיף לרשימה (ברירת מחדל: 'בסיס')
findFileOrFolderInMyOnedrive
איתור קובץ או תיקיה (DriveItem) בתיבת הדו-שיח של OneDrive לפי שאילתת חיפוש. שיטה זו יעילה יותר מחיפוש בכל הקבצים הנגישים אם אתה יודע שהפריט נמצא בקובץ ה- OneDrive.
פרמטרים נדרשים:
- searchQuery: שאילתת חיפוש; יכול להיות שם הקובץ כולו או החלקי
getFileOrFolderMetadataInMyOnedrive
קבלת מטה-נתונים של קובץ או תיקיה (DriveItem) ממטה-נתונים של OneDrive.
פרמטרים נדרשים:
- fileOrFolderId: מזהה הקובץ או התיקיה בקובץ ה- OneDrive
getFileOrFolderMetadataByUrl
קבלת מטה-נתונים של קובץ או תיקיה (DriveItem) מכתובת URL לשיתוף. רק משתמשים בעלי הרשאות מפורשות קיימות לגשת לקובץ יכולים לקבל את המטה-נתונים.
פרמטרים נדרשים:
- fileOrFolderUrl: כתובת ה- URL של הקובץ או התיקיה. כתובת ה- URL אינה מומשת כדי לשתף אותה עם המשתמש; דרושה להם כבר גישה מפורשת.
קרא קובץ טקסט קטן מה-OneDrive שלי
קורא (מוריד) קובץ טקסט מ-OneDrive של המשתמש.
פרמטרים נדרשים:
- מזהה קובץ: מזהה הקובץ (DriveItem) לקריאה או להורדה
createSmallTextFileInMyOnedrive
יצירה או העלאה של קובץ טקסט הקטן מ- 5 MB לקובץ ה- OneDrive.
פרמטרים נדרשים:
- Filename: שם הקובץ ליצירה
- תוכן טקסט: תוכן טקסט של הקובץ.
פרמטרים אופציונליים:
- parentFolderId: מזהה של תיקיית ההורה (ברירת מחדל: 'root').
createFolderInMyOnedrive
יצירת תיקיה חדשה (DriveItem) ברשימת OneDrive כצאצא של תיקיית האב שצוינה. אם תיקיה בשם זה כבר קיימת, פעולת השירות מוסיפה סיומת מספרית (לדוגמה, NewFolder (1)).
פרמטרים נדרשים:
- שם תיקיה: שם התיקיה ליצירה
פרמטרים אופציונליים:
- parentFolderId: מזהה של תיקיית ההורה (ברירת מחדל: 'root').
renameFileOrFolderInMyOnedrive
שינוי שם של קובץ או תיקיה (DriveItem) בתיבת הדו-שיח של OneDrive. השם החדש חייב לציית למוסכמות מתן שמות.
פרמטרים נדרשים:
- fileOrFolderId: מזהה הקובץ או התיקיה לשינוי שם
- newFileOrFolderName: השם החדש עבור הקובץ או התיקיה
פרמטרים אופציונליים:
- etag: ערך ETag עבור בקרת בו-זמניות. הפעולה מצליחה רק אם ה- ETag הנוכחי של DriveItem תואם
מחק קובץ או תיקיה ב-OneDrive שלי
מוחק קובץ או תיקייה (DriveItem) מ-OneDrive של המשתמש.
פרמטרים נדרשים:
- fileOrFolderId: מזהה הקובץ או התיקיה למחיקה
פרמטרים אופציונליים:
- etag: ערך ETag עבור בקרת מקביליות
שתף קובץ או תיקיה ב-OneDrive שלי
שליחת הזמנה לשיתוף כדי להעניק הרשאות קריאה או כתיבה בקובץ או בתיקיה (DriveItem) בתיבת הדו-שיח של OneDrive.
פרמטרים נדרשים:
- fileOrFolderId: מזהה הקובץ או התיקיה לשיתוף
- recipientEmails: מערך של כתובות אימייל של הנמענים שיש להזמין
- תפקידי: מערך תפקידים להקצאה. ערכים מקובלים: 'קריאה', 'כתיבה' (כתיבה מעניקה הן קריאה והן כתיבה)
פרמטרים אופציונליים:
- ההודעה: הודעה מותאמת אישית שייכללו בדואר האלקטרוני של ההזמנה. ברירת מחדל: 'הנה הקובץ שאנחנו משתפים פעולה לגביו'.
- הזמנה לשליחה: אם לשלוח הזמנה לשיתוף. ברירת מחדל: true.
הגדרת תווית רגישות על קובץ ב-OneDrive שלי
הגדרת תווית הרגישות של קובץ בתיבת הדו-שיח של OneDrive.
פרמטרים נדרשים:
- מזהה קובץ: מזהה הקובץ (DriveItem)
- מזהה תווית רגישות: מזהה של תווית הרגישות להקצאה או מחרוזת ריקה להסרה
פרמטרים אופציונליים:
- נתוני הקצאה: שיטת הקצאה: 'standard', 'privileged', 'auto' או 'unknownFutureValue' (ברירת מחדל: 'privileged')
- טקסט הצדקה: טקסט הצדקה לצורכי ביקורת; נדרש בעת הנמכת תווית או הסרת תווית (ברירת מחדל: 'שונה על-ידי MCPServer')
צור קובץ בינארי קטן ב-OneDrive שלי
יצירת קובץ בינארי בגודל של פחות מ- 5 MB על-ידי קידוד base64 של התוכן שלו לקידוד התוכן של המשתמש OneDrive.
פרמטרים נדרשים:
- Filename: שם הקובץ ליצירה, כולל סיומת הקובץ
- base64Content: תוכן הקובץ הבינארי מקודד כמחרוזת base64
פרמטרים אופציונליים:
- parentFolderId: מזהה של תיקיית ההורה (ברירת מחדל: 'root').
קראקובץבינאריקטןמה-OneDriveשלי
קורא קובץ בינארי שגודלו קטן מ-5 MB מה-OneDrive של המשתמש. החזרת תוכן הקובץ כמחרוזת בקידוד base64.
פרמטרים נדרשים:
- מזהה קובץ: מזהה הקובץ (DriveItem) לקריאה או להורדה
העתק קובץ או תיקייה ב-OneDrive שלי
העתקת קובץ או תיקיה (DriveItem) אל תיקיית יעד בתוך תיקיית OneDrive. פעולה זו אסינכרונית. השתמש ב־checkOperationStatusInMyOnedrive כדי לנטר את ההתקדמות.
פרמטרים נדרשים:
- מזהה מקור: מזהה של קובץ המקור או התיקיה (DriveItem) להעתקה
- destfolderid: מזהה של תיקיית היעד (חייב להיות קיים ב- OneDrive)
פרמטרים אופציונליים:
- שם קובץ חדש: שם חדש עבור הפריט שהועתק (ברירת המחדל היא השם המקורי)
moveFileOrFolderInMyOnedrive
העברת קובץ או תיקיה (DriveItem) אל תיקיית יעד בתוך תיקיית OneDrive. פעולה זו אסינכרונית. השתמש ב־checkOperationStatusInMyOnedrive כדי לנטר את ההתקדמות.
פרמטרים נדרשים:
- מזהה מקור: מזהה קובץ המקור או התיקיה המשמשים כמקור (DriveItem) לתזוזה
- destfolderid: מזהה של תיקיית היעד (חייב להיות קיים ב- OneDrive)
פרמטרים אופציונליים:
- שם קובץ חדש: שם חדש עבור הפריט שהועבר (ברירות מחדל לשם המקורי)
בדוק את מצב הפעולה ב-OneDrive שלי
בדיקת המצב של פעולה אסינכרונית, כגון העתקה או העברה, באמצעות אסימון הפעולה המוחזר מהפעולה המקורית. מחזירה מידע התקדמות אם עדיין מתבצע, פרטי שגיאה אם הם נכשלים, או את המטה-נתונים הסופיים של הקובץ או התיקיה, אם הושלמו בהצלחה.
פרמטרים נדרשים:
-
operationToken: אסימון הפעולה שהוחזר מפעולה אסינכרונית כגון
copyFileOrFolderInMyOnedriveאוmoveFileOrFolderInMyOnedrive
תכונות מרכזיות
OneDrive הנהלה
- מקבל מידע על OneDrive, כגון מכסה ובעלים
- גישה להגדרות האישיות של המשתמש OneDrive
- כל הפעולות מיועדות ל-OneDrive של המשתמש המאומת
חיפוש וגילוי קבצים
- חפש קבצים ותיקיות לפי שם בתוך פרטי OneDrive
- קבל מטה-נתונים של קובץ או תיקיה לפי מזהה או כתובת URL לשיתוף
- עיין בתוכן התיקיות (עד 20 פריטים).
פעולות קובץ
- יצירת טקסט וקבצים בינאריים (≤5 MB)
- קריאת טקסט וקבצים בינאריים (≤5 MB)
- מחיקת קבצים עם בקרת מקביליות
- שינוי שם של קבצים באמצעות הגנה על eTag
- העתקה ועברה של קבצים ותיקיות באופן אסינכרוני
ניהול תיקיות
- יצירת תיקיות עם נתיבי אב אופציונליים
- סיומת מספרית אוטומטית לשמות תיקיות כפולות.
- פרט תוכן תיקיה (עד 20 פריטים)
- קבל מטה-נתונים של תיקיה
- מחק תיקיות עם בקרת מקביליות
- שינוי שם של תיקיות באמצעות הגנה על eTag
שיתוף והרשאות
- שיתוף קבצים ותיקיות עם משתמשים
- בקרת גישה מבוססת תפקיד (קריאה, כתיבה)
- הודעות בדוא"ל לשיתוף.
- הודעות מותאמות בהזמנות.
אבטחה ותאימות
- החלה והסרה של תוויות רגישות.
- השתמש בשיטות הקצאה מרובות, כולל תקן, הרשאות וא אוטומטי.
- תמיכה בהצדקת ביקורת
- השתמש בבקרת בו-זמניות עם eTags.
הערות
- כל הפעולות מכוונות אל ה-OneDrive האישי של המשתמש המאומת.
- פעולות קבצים מוגבלות לקבצים שנפחם 5 MB או פחות להעלאה ולהורדה.
- פעולות מחיקה ושינוי שם תומכות ב-eTags לצורך בקרת בו-זמניות.
- שיתוף דורש כתובות דואר אלקטרוני חוקיות והרשאות מתאימות.
- תוויות רגישות דורשות רישוי ותצורה נאותים.
- רישום תיקיות מחזיר עד 20 פריטים כברירת מחדל.