PowerShell மூலம் Microsoft Graph-க்கு Managed Identity பயன்படுத்துதல்

As businesses increasingly rely on Microsoft 365, automating management tasks becomes essential. Integrating PowerShell + Graph API can enhance efficiency and save valuable time. This powerful combination unlocks robust management capabilities that streamline operations.

However, many users encounter challenges. For instance, some key functionalities lack documented endpoints, complicating automation efforts. Additionally, legacy APIs may lead to silent failures, hindering your scripts' maintainability. Don't worry! This post will break down these complex concepts into easy, actionable steps, guiding you through the process with clear solutions.

முக்கிய குறிப்புகள்

• Microsoft 365 பணிகளை தானியக்கமாக்கவும் செயல்திறனை மேம்படுத்தவும் PowerShell-ஐ Graph API உடன் ஒருங்கிணைக்கவும்.
• சீரான செயல்பாட்டிற்கு PowerShell 7 அல்லது அதற்கு மேற்பட்ட பதிப்பு மற்றும் சமீபத்திய Microsoft Graph module போன்ற முன்நிபந்தனைகள் உங்கள் அமைப்பில் இருப்பதை உறுதிசெய்யவும்.
• அனுமதிகள் மற்றும் scopes-ஐப் புரிந்துகொள்ளவும். குறைந்தபட்ச சிறப்புரிமை கொள்கையைப் பின்பற்றி, உங்கள் scripts Microsoft 365-இல் எதை அணுகலாம் என்பதைக் கட்டுப்படுத்தவும்.
• Azure AD-இல் உங்கள் app-ஐப் பதிவு செய்யவும். Microsoft Graph-ஐ பாதுகாப்பாக அணுக உங்கள் scripts-க்கு ஒரு பாதுகாப்பான அடையாளத்தை உருவாக்கவும்.
• உங்கள் access tokens-ஐ திறம்படப் பாதுகாக்க Device Code Flow அல்லது Managed Identity Flow போன்ற சரியான authentication flow-ஐத் தேர்ந்தெடுக்கவும்.
• Microsoft Graph API-உடன் தொடர்புகொண்டு தரவைப் பெற PowerShell பயன்படுத்தி சரியான வடிவத்தில் HTTP கோரிக்கைகளை உருவாக்கவும்.
• உங்கள் scripts சீராக இயங்கவும் இடையூறுகளைத் தவிர்க்கவும் பிழைகளையும் API வரம்புகளையும் கவனமாகக் கையாளவும்.
• தேவையான பண்புகளை மட்டும் பெறுதல் மற்றும் கோரிக்கைகளை batching செய்தல் மூலம் உங்கள் scripts-ஐ மேம்படுத்தி செயல்திறனை அதிகரித்து வளப் பயன்பாட்டைக் குறைக்கவும்.

PowerShell + Graph API-க்கான முன்நிபந்தனைகள்

PowerShell + Graph API மூலம் Microsoft 365 பணிகளை தானியக்கமாக்கத் தொடங்குவதற்கு முன், உங்கள் அமைப்பையும் சூழலையும் சரியாகத் தயார்படுத்த வேண்டும். இந்தத் தயாரிப்பு சீரான செயல்பாட்டையும் Microsoft Graph வளங்களுக்கான பாதுகாப்பான அணுகலையும் உறுதி செய்கிறது.

PowerShell Modules-ஐ நிறுவுதல்

Microsoft Graph API-உடன் தொடர்புகொள்ள சரியான PowerShell modules-ஐ நிறுவ வேண்டும். Microsoft Graph PowerShell SDK இந்த ஒருங்கிணைப்புக்குத் தேவையான அனைத்து cmdlets-ஐயும் வழங்குகிறது. பிழைகளைத் தவிர்க்க, உங்கள் அமைப்பு இந்தக் குறைந்தபட்சத் தேவைகளைப் பூர்த்தி செய்கிறதா என்று சரிபார்க்கவும்:

தேவை	விளக்கம்
PowerShell பதிப்பு	PowerShell பதிப்பு 7 அல்லது அதற்கு மேல் தேவை.
.NET Framework	macOS-இல் .NET Framework 4.7.2 அல்லது அதற்குப் பிந்தையது அவசியம்.
PowerShellGet	PowerShellGet-ஐ சமீபத்திய பதிப்புக்கு புதுப்பிக்கவும்.
Execution Policy	Execution policy-ஐ remote signed அல்லது குறைவான கட்டுப்பாடுள்ளதாக அமைக்கவும்.

PowerShellGet-ஐ Install-Module PowerShellGet -Force இயக்கி புதுப்பிக்கலாம்; execution policy-ஐ Set-ExecutionPolicy RemoteSigned மூலம் அமைக்கலாம். அதன் பின் Microsoft Graph module-ஐ இவ்வாறு நிறுவவும்:

Install-Module Microsoft.Graph -Scope CurrentUser

இந்தக் கட்டளை module-இன் சமீபத்திய நிலையான பதிப்பைப் பதிவிறக்குகிறது; இதன் மூலம் Microsoft Graph endpoints-ஐ எளிதாக அழைக்கலாம்.

Microsoft 365 சூழலை அமைத்தல்

தானியக்கத்திற்கு உங்கள் Microsoft 365 சூழலை சரியாக உள்ளமைப்பது முக்கியம். தொடங்குவதற்கு இந்தப் படிகளைப் பின்பற்றவும்:

1. உங்கள் அமைப்பு தேவைகளைப் பூர்த்தி செய்கிறதா என உறுதிசெய்யவும்: PowerShell 7.2 அல்லது அதற்குப் பிந்தையது, .NET Framework 4.7.2 அல்லது புதியது, மற்றும் சமீபத்திய PowerShellGet module.
2. மேலே காட்டப்பட்டபடி Microsoft Graph PowerShell module-ஐ நிறுவவும்.
3. Module-ஐ இறக்குமதி செய்து தேவையான scopes-உடன் அங்கீகரித்து உங்கள் Microsoft 365 tenant-உடன் இணைக்கவும். எடுத்துக்காட்டாக:

Connect-MgGraph -Scopes "User.ReadWrite.All","Directory.ReadWrite.All"

இந்தக் கட்டளை நீங்கள் உள்நுழைய வேண்டும் எனக் கேட்கும்; உங்கள் அமர்வுக்கு பயனர் மற்றும் directory தரவைப் படிக்கவும் எழுதவும் அனுமதி வழங்கும். உங்கள் தானியக்கத் தேவைக்கு ஏற்ப scopes-ஐ மாற்றலாம்.

அனுமதிகளையும் Scopes-ஐயும் புரிந்துகொள்ளுதல்

அனுமதிகளும் scopes-உம் Microsoft 365-இல் உங்கள் scripts எதை அணுகலாம் அல்லது மாற்றலாம் என்பதை வரையறுக்கின்றன. Microsoft Graph API இரண்டு முக்கிய அனுமதி வகைகளைப் பயன்படுத்துகிறது:

• Delegated அனுமதிகள்: நீங்கள் உள்நுழைந்த பயனராக scripts-ஐ இயக்கும்போது இவை பொருந்தும். பயனர் சொந்தமாக வைத்திருக்கும் அல்லது அணுக முடிந்த தரவுக்கு மட்டுமே அணுகலை இவை வரையறுக்கின்றன.
• Application அனுமதிகள்: உள்நுழைந்த பயனர் இல்லாமலேயே உங்கள் app அல்லது script நிறுவனம் முழுவதும் தரவை அணுக இவை அனுமதிக்கின்றன.

பொதுவான அனுமதிகளில் படிக்க மட்டும் அணுகலுக்கான *.Read.All மற்றும் முழு படிப்பு, எழுதுதல் திறனுக்கான *.ReadWrite.All அடங்கும். எடுத்துக்காட்டாக, SecurityActions.Read.All security actions-ஐப் பார்க்க அனுமதிக்கிறது; SecurityActions.ReadWrite.All அவற்றை மாற்ற அனுமதிக்கிறது.

Application அனுமதிகளுக்கு admin ஒப்புதல் தேவை. பாதுகாப்பை உறுதிசெய்ய tenant நிர்வாகி இந்த அனுமதிகளை அங்கீகரிக்க வேண்டும். மேலும், முக்கியத் தரவை அணுக பயனர்களுக்கு Security Reader போன்ற பொருத்தமான Microsoft Entra roles தேவை. இந்தப் பங்கு அடிப்படையிலான அணுகல் கூடுதல் பாதுகாப்பு அடுக்கைச் சேர்க்கிறது.

Microsoft Graph PowerShell SDK மூலம் இணைக்கும்போது, உங்கள் script-க்குத் தேவையான scopes-ஐ மட்டும் குறிப்பிடவும். இந்த நடைமுறை குறைந்தபட்ச சிறப்புரிமைக் கொள்கையைப் பின்பற்றுகிறது; பாதுகாப்பு அபாயங்களைக் குறைக்கிறது. உங்கள் app-க்கு வழங்கப்பட்ட அனுமதிகள் அந்த app-ஐப் பயன்படுத்தும் அனைத்துப் பயனர்களுக்கும் பொருந்தும் என்பதால், அவற்றை வழக்கமாக மதிப்பாய்வு செய்து நிர்வகிக்கவும்.

அனுமதிகளைக் கவனமாகப் புரிந்துகொண்டு உள்ளமைப்பதன் மூலம், உங்கள் சூழலைப் பாதுகாத்துக்கொண்டே PowerShell + Graph API மூலம் சக்திவாய்ந்த தானியக்கத்தை இயக்கலாம்.

Azure AD-இல் App அடையாளம்

புதிய App-ஐப் பதிவு செய்தல்

PowerShell மற்றும் Graph API மூலம் Microsoft 365 பணிகளை தானியக்கமாக்க, முதலில் Azure Active Directory (Azure AD)-இல் ஒரு application-ஐப் பதிவு செய்ய வேண்டும். இந்த app, உங்கள் scripts Microsoft Graph-ஐ பாதுகாப்பாக அணுகப் பயன்படுத்தும் அடையாளமாகச் செயல்படுகிறது. உங்கள் app-ஐப் பதிவு செய்ய இந்தப் படிகளைப் பின்பற்றவும்:

1. Azure portal-ஐத் திறந்து Azure Active Directory > App registrations > New registration என்பதற்குச் செல்லவும்.
2. "My Graph App" போன்ற அர்த்தமுள்ள பெயரை உங்கள் app-க்குக் கொடுக்கவும்.
3. ஆதரிக்கப்படும் கணக்கு வகைகளைத் தேர்ந்தெடுக்கவும்:
   • Single tenant: உங்கள் Azure AD tenant-இல் உள்ள பயனர்கள் மட்டுமே உள்நுழைய முடியும்.
   • Multi-tenant: எந்தவொரு Azure AD tenant-இன் பயனர்களும் உள்நுழையலாம்.
   • Multi-tenant and personal accounts: Azure AD பயனர்கள் மற்றும் தனிப்பட்ட Microsoft கணக்குகளையும் உள்ளடக்கும்.