Klašu nodrošināšana lielā mērogā, izmantojot PowerShell un Microsoft Graph

Tā kā Microsoft uzlabo drošības stāvokli visos produktos un pakalpojumos, ir veiktas izmaiņas API funkcionalitātē, kas var ietekmēt klientus, kuri iepriekš paļāvās uz tikai programmu atļaujām, lai nodrošinātu klases piezīmju grāmatiņas un klases grupas, izmantojot API.

Jūs joprojām varat nodrošināt klases un piezīmju grāmatiņas lielā mērogā, izmantojot PowerShell un Microsoft Graph, ievērojot tālāk norādītās atbalstītās metodes. Šajā rakstā ir aprakstītas darbības un sniegtas saites uz atbilstošo dokumentāciju.

Jaunu klašu nodrošināšana

1. iespēja (ieteicams): Teams PowerShell izmantošana

Jaunas nodarbības var vienkārši nodrošināt, izmantojot Teams PowerShell, kas ietvers visu nepieciešamo iestatīšanu klasēm un piezīmju grāmatiņām. Vienkārši pielāgojiet vēlamo parādāmo vārdu tālāk norādītajā skriptā un palaidiet to kā administrators.

Skripta paraugs

# Teams PowerShell SDK izmantošana Install-Module -MicrosoftTeams -force -AllowClobber New-Team -DisplayName 'Testa klase 20251208.4' -Template 'EDU_Class'

2. opcija. Microsoft Graph PowerShell izmantošana

Ja jums nav piekļuves Teams PowerShell, iespējams, vēlēsities izpētīt nodrošināšanas klases plašā mērogā, izmantojot Microsoft Graph. Atbilstoši rediģējiet parametrus tālāk norādītā skripta augšdaļā un pēc tam izpildiet skriptu kā administrators, lai nodrošinātu klases un piezīmju grāmatiņas plašā mērogā:

Skripta paraugs

# MS Graph API izmantošana Install-Module Microsoft.Graph -AllowClobber -Force # PARAMETERS $Name = "Testa klase 20251208.3" $Description = "Testa klase" $Mail = $Name -replace '[^a-zA-Z0-9\s]|[ ]', '' # Aizstāt šo pasta aizstājvārdu ar vēlamo ģenerēšanas metodi $OwnerId = "000-000-00000-000000-0000" # Aizstājiet to ar īpašnieka GUID # ------------ # Jaunas M365 grupas izveide $CreateGroupBody = @" { "description": "$Name", "displayName": "$Description", "groupTypes": [ "Unified" ], "mailEnabled": false, "mailNickname": "$Mail", "securityEnabled": false, "": [members@odata.bind "https://graph.microsoft.com/v1.0/users/$OwnerId" ], "owners@odata.bind": [ "https://graph.microsoft.com/v1.0/users/$OwnerId" ], "visibility": "HiddenMembership", "creationOptions": [ "ExchangeProvisioningFlags:461", "classAssignments" ], "extension_fe2174665583431c953114ff7268b7b3_Education_ObjectType": "Section", "resourceBehaviorOptions": [ "appRoleForSite:22d27567-b3f0-4dc2-9ec2-46ed368ba538:fullcontrol", "appRoleForSite:c9a559d2-7aab-4f13-a6ed-e7e9c52aec87:fullcontrol", "appRoleForSite:13291f5a-59ac-4c59-b0fa-d1632e8f3292: fullcontrol", "appRoleForSite:2d4d3d8e-2be3-4bef-9f87-7875a61c29de:fullcontrol", "appRoleForSite:8f348934-64be-4bb2-bc16-c54c96789f43:fullcontrol" ] } "@ $NewGroup = Invoke-MgGraphRequest -uri 'https://graph.microsoft.com/v1.0/groups/' -Body $CreateGroupBody -Method POST -ContentType "application/json" # Create Teams Class Team from group $CreateTeamBody = @{ "template@odata.bind" = "https://graph.microsoft.com/v1.0/teamsTemplates('educationClass')" "group@odata.bind" = "https://graph.microsoft.com/v1.0/groups('$($NewGroup.Id)')" } New-MgTeam -BodyParameter $CreateTeamBody

Problēmu novēršana: atļauju piešķiršana esošām mācību priekšmeta vietnēm

Ja jums jau ir nodrošinātas nodarbības un novērojat kļūmes vai atļauju problēmas saistībā ar klases piezīmju grāmatiņas vai Teams uzdevumiem, varat atjaunināt vietnes atļaujas savām klasēm, izmantojot tālāk norādīto skriptu, aizstājot rawGroups parametru ar ietekmēto klašu groupID:

Skripta paraugs

#You būs jāizveido savienojums ar SharePoint, Exchange Online un Graph ar šādiem -Scopes Sites.FullControl.All, kā arī jāapkopo ietekmēto klases grupu grupu ID, $rawGroups =@("b0a5905d-09ae-4605-8e12-94da93ecbe92","e0eec729-24ef-451e-b079-56d0baf4dfc9") # Konvertēt par objektu masīvu ar .groupid $groups = $rawGroups | ForEach-Object { Get-UnifiedGroup -Identity $_ } $step = 0 #get lietotāja konta, kurš pašlaik ir pieteicies, lai to pievienotu kā vietnes administratoru $CUA = (get-mgcontext).account foreach ($group $groups) { $step = $step + 1 Set-SPOUser -Site $group. SharePointSiteUrl -LoginName $CUA -IsSiteCollectionAdmin $true Write-Host "SiteCollectionAdmin added on $step of $($Groups.Count) Class Sites" } #Pause 5 minūtes pirms vispārīgās mapes izveides Write-Host "Pauze 5 minūtes pirms pastāvīgo ziņojumu pievienošanas, lai ļautu SiteCollectionAdmin izplatīt" Start-Sleep -Seconds 300 Write-Host "Strādā ar $($Groups.Count) klasēm" foreach ($group $groups) { #$step = $step + 1 $Site = Get-MgGroupSite -GroupId $group. ExternalDirectoryObjectId -SiteId "root" $SiteId = $Site.Id Write-Host "Notiek atļauju apstrāde $($Groups.Count) klašu $step" # Šie ir biežāk izmantoto Microsoft EDU programmu AppId $AppIds = @{ "8f348934-64be-4bb2-bc16-c54c96789f43"="EDU uzdevumi"; "22d27567-b3f0-4dc2-9ec2-46ed368ba538"="Lasīšanas uzdevumi"; "2d4d3d8e-2be3-4bef-9f87-7875a61c29de"="OneNote"; "c9a559d2-7aab-4f13-a6ed-e7e9c52aec87"="Microsoft Forms"; " 13291f5a-59ac-4c59-b0fa-d1632e8f3292"="EDU OneNote"; } # Lietojiet atļaujas grupas vietnei $AppIds.Keys | %{ $AppId = $_ $Name = $AppIds[$_] $Body = @" { "lomas": ["fullcontrol"], "grantedToIdentities": [{ "application": { "id": "$AppId", "displayName": "$Name" } }] } "@ Invoke-MgGraphRequest -Method POST -Uri "https://graph.microsoft.com/v1.0/sites/$SiteId/permissions" -Body $Body -ContentType "application/json" } } Write-Host "Apstrādātas $($Groups.Count) klases, notiek vietņu kolekcijas administratora noņemšana" $step = 0 foreach ($group $groups) { $step = $step + 1 Set-SPOUser -Site $group. SharePointSiteUrl -LoginName $CUA -IsSiteCollectionAdmin $false Write-Host "SiteCollectionAdmin noņemts $step no $($Groups.Count) klases vietnēm" }