Mehmet PARLAKYİĞİT
Office Apps & Services MVP
twitter: mparlakyigit
2
İÇİNDEKİLER
Microsoft Teams Modülünün PowerShell Üzerine Yüklenmesi …............................. 3
PowerShell Kullanarak Microsoft Teams’e Bağlanma …............................. 4
Takım Yönetimi …............................. 6
Mevcut Takımları Listeleme …............................. 6
Yeni Bir Takım Oluşturma …............................. 6
Yeni Bir Takım Oluşturma ve Erişim Tipini Belirleme …............................. 6
Takım İsminin Değiştirilmesi …............................. 7
Mevcut Bir Takımın Silinmesi …............................. 7
Takımın Görüntü Resminin Değiştirilmesi …............................. 7
Kanal Yönetimi …............................. 8
Takım İçerisinde Bulunan Kanalların Listelenmesi …............................. 8
Kanal İsminin Değiştirmesi …............................. 8
Yeni Kanal Oluşturma …............................. 9
Kanalın Silinmesi …............................. 9
Kanal Üyelerinin Yetkilerini Görüntüleme …............................. 9
Ekip Üyelerinin Yetkilerinin Değiştirilmesi …............................. 10
Kullanıcı Yönetimi …............................. 11
Mevcut Kullanıcının hangi Takım İçerisinde Olduğunu
Görüntüleme …............................. 11
Takım İçerisine Yeni Üye Ekleme …............................. 12
Takım İçerisinde Bulunan Üyenin Silinmesi …............................. 12
Owner Yetkisine Sahip Kullanıcıları Listeleme …............................. 12
Üye Yetkisine Sahip Kullanıcıları Listeleme …............................. 12
Tüm Üyeler İçin Mesajlaşma Yetkilerini Görüntüleme …............................. 13
Tüm Üyeler İçin Mesajlaşma Yetkilerinin Değiştirilmesi …............................. 13
Konuk Kullanıcıların Yetkilerini Görüntüleme …............................. 13
Konuk Kullanıcıların Yetkilerinin Değiştirilmesi …............................. 14
Kaynaklar …............................. 14
3
İlk bölümümüzde Microsoft Teams’i PowerShell ile yönetebilmemiz için ön hazırlıklarımızı nasıl yapacağımızı
göreceğiz. Böylelikle Microsoft Teams’e PowerShell ile bağlanarak bir çok işlemimizi PowerShell üzerinden gerçekleştirmiş
olacağız. Buarada değinmek istediğim birkaç konu var. Öncelikle yaptığımız uygulamalı örneklerde Get-Team komutunu
sıklıkla kullandığımızı görebilirsiniz. Bunun nedeni, Microsoft Teams üzerinde oluşturulan her takımın bir GroupId
bulunmaktadır. Örneğin var olan bir takıma yeni bir üye eklemek istediğimizde bizden GroupId istenecektir. Kısacası takım ile
ilgili yapacağımız her işlem için GroupId ye ihtiyacımız olacaktır. Zaten örnek uygulamalarda bunu özellikle göstermek istedim.
Yukarıda ki görsele baktığımızda ilgili komutu verdiğimizde şuan Microsoft Teams üzerinde 4 farklı takım oluşturulmuş ve her
takımın GroupId bir birinden farklı görünüyor. Bu komutu örneklerimizde sıklıkla kullanacağız.
Microsoft Teams Modülünün PowerShell Üzerine Yüklenmesi
4
Microsoft Teams’si PowerShell üzerinden yönetebilmemiz için öncelikle Microsoft Teams modülünü mevcut bilgisayarımızda
bulunan PowerShell yüklememiz gerekir. Öncelikle PowerShell’i yönetici olarak çalıştıralım.
Hemen ardından aşağıda ki komutu PowerShell yazalım.
Install-Module -Name MicrosoftTeams -RequiredVersion 0.9.6
Çıkan tüm uyarılara “y” yazarak devam delim. Böylelikle Microsot Teams modülünü PowerShell eklemiş olacağız. Mecut
PowerShell modüllerine aşağıda ki linkten ulaşabilirsiniz.
https://www.powershellgallery.com/packages/MicrosoftTeams/0.9.6
PowerShell Kullanarak Microsoft Teams’e Bağlanma
https://www.powershellgallery.com/packages/MicrosoftTeams/0.9.6
5
Microsoft Teams modülümüzü yüklediğimize göre artık. Microsoft Teams yönetebilmemiz için PowerSell üzerinden bağlantı
yapmamız gerekecektir. Bunun için aşağıda ki komutu girelim.
Connect-MicrosoftTeams
Bağlantı komutumuzu girdiğimizde sistem bizden Kullanıcı adımız ve parolamızı isteyecektir. Giriş yaptığımız kullancının
Gloabal Admin yetkisine sahip olması gerekir aksi taktirde bir bağlantı gerçekleştiremeyeceğiz.
Başarılı bir şekilde Microsoft Teams bağlandık.
Get-TeamHelp
İlk komutumuz yukarıda ki görselde olduğu gibi help komutu burada hangi cmdsetleri kullanabileceğimizi görebiliriz. Şimdilik
fazla bir cmdset yok ama ilerleyen zamanlarda Microsoft Teams yeni özellikler ve yeni teknikler gelecektir. Güncel PowerShell
setlerine aşağıda ki linkten ulaşabilirsiniz.
6
Takım Yönetimi
Artık Microsoft Teams için uygulamalı örneklerimize başlayabiliriz. Bu bölümde Microsoft Teams içerisinde bulunan
takımların yönetiminden bahsedeceğiz. Yeni bir takım nasıl oluşturulur. Takım ismi nasıl değiştirilir gibi örneklere değineceğiz.
Böylelikle Office 365 Portalına girmeden PowerShell üzerinden işlemlerimizi gerçekleştireceğiz.
Mevcut Takımları Listeleme
Organizasyon içerisinde bulunan Takımları ve GroupId lerin görüntülenmesini sağlar.
Get-Team
Yeni Bir Takım Oluşturma
Yeni bir takım oluşturarak Grup Idsini verir.
New-Team -DisplayName "Takım ismi"
Yeni Bir Takım Oluşturma ve Erişim Tipini Belirleme
Yeni Bir takım oluşturarak Takım için bir açıklama ve Erişim tipinin belirlenmesini sağlar. (Public,Private)
New-Team -DisplayName "Test Takımı" -Description "Takım Açıklaması" -AccessType Public
7
Takım İsminin Değiştirilmesi
Mevcut bir takım ismin değiştirilmesini sağlar.
Set-Team -GroupId 08bc065e-feb8-410f-8bcf-d1d616c59607 -DisplayName "Office 365 TR Community"
Mevcut Bir Takımın Silinmesi
Mevcut bir takımın silinmesini sağlar. İlgili takımı kaldırmak için Grup Id numarasının daha öncedem öğrenilmesi gerekir. (Get-Team)
Remove-Team -GroupId 071b222d-a8f6-44fd-ba10-990da524e909
Takımın Görüntü Resminin Değiştirilmesi
8
Kendi bilgisayarımızda bulunan bir resmi mevcut bir takımın görünen resimi olarak ekleyebilirsiniz.
Set-TeamPicture -GroupId 08bc065e-feb8-410f-8bcf-d1d616c59607 -ImagePath C:\1.jpg
Kanal Yönetimi
Bu bölümde Microsoft Teams içerisinde bulunan takımlara ait kanalların yönetiminden bahsedeceğiz. Yeni bir kanal nasıl oluşturulur. Kanal ismi nasıl değiştirilir gibi örneklere değineceğiz. Böylelikle Office 365 Portalına girmeden PowerShell üzerinden işlemlerimizi gerçekleştireceğiz Takım İçerisinde Bulunan Kanalların Listelenmesi
Bir takım içerisinde bulunan kanalların listesini gösterir. GrupId numarasının daha öncedem öğrenilmesi gerekir.
Get-TeamChannel -GroupId 7054a02b-ebd7-46e9-9f2e-fdd25c4358e2
Kanal İsminin Değiştirmesi
Mevcut bir takım içerisinde buluanan kanalın isminin değiştirilmesini sağlar.
Set-TeamChannel -GroupId 08bc065e-feb8-410f-8bcf-d1d616c59607 -CurrentDisplayName Test3 -NewDisplayName "Help and Tools"
9
Yeni Kanal Oluşturma
Mevcut bir takım içerisine yeni bir kanal eklenmesini sağlar.
New-TeamChannel -GroupId 08bc065e-feb8-410f-8bcf-d1d616c59607 -DisplayName "Tools"
Kanalın Silinmesi
Bir Takım içerisinde bulunan Kanalın silinmesini sağlar.
Remove-TeamChannel -GroupId 08bc065e-feb8-410f-8bcf-d1d616c59607 -DisplayName "Test"
Kanal Üyelerinin Yetkilerini Görüntüleme
Mevcut takım için takım üyelerinin yetkileriniı listeler.
Get-TeamMemberSettings -GroupId 08bc065e-feb8-410f-8bcf-d1d616c59607
10
Ekip Üyelerinin Yetkilerinin Değiştirilmesi
Mevcut takım içerisinde buluanan kanalların ekip üyeleri için yetkilerin değiştirilmesini sağlar.
Set-TeamMemberSettings -GroupId 08bc065e-feb8-410f-8bcf-d1d616c59607 -AllowDeleteChannels true -AllowAddRemoveApps false
Burada yaptığımız uygulamayla kanal içerisinde bulunan üyelerin uygulama yükleme gibi izinlerini kapatmış olduk.
11
Eğer Teams yönetim panelinden bakarsak uygulamamızı başarılı bir şekilde yaptığımızı görebiliriz.
Kullanıcı Yönetimi
Bu bölümde Microsoft Teams içerisinde bulunan kullanıcıların yönetiminden bahsedeceğiz. Mevcut takımlariçerisine
nasıl yeni üye eklenir, mevcut üyelerin yetkileri nasıl değiştirilir gibi konulara değineceğiz. Böylelikle Office 365 Portalına
girmeden PowerShell üzerinden işlemlerimizi gerçekleştireceğiz.
Mevcut Kullanıcının hangi Takım İçerisinde Olduğunu Görüntüleme
Get-Team -User user@domain_name.org
mailto:user@domain_name.org
12
Belirli bir kullanıcının hangi takıma üye olduğunun görüntülenmesini sağlar.
Takım İçerisine Yeni Üye Ekleme
Add-TeamUser -GroupId 08bc065e-feb8-410f-8bcf-d1d616c59607 -User [email protected]
Mevcut takım içerisine yeni bir üye eklenmesini sağlar.
Takım İçerisinde Bulunan Üyenin Silinmesi
Remove-TeamUser -GroupId 08bc065e-feb8-410f-8bcf-d1d616c59607 -User [email protected]
Belirtilen takım içerisinde bulunan bir kullanıcıyı kaldırır.
Owner Yetkisine Sahip Kullanıcıları Listeleme
Get-TeamUser -GroupId 08bc065e-feb8-410f-8bcf-d1d616c59607 -Role Owner
İlgili takım içerisinde Owner (Sahip) yetkisine sahip olan kullanıcıları listeler.
Üye Yetkisine Sahip Kullanıcıları Listeleme
Get-TeamUser -GroupId 08bc065e-feb8-410f-8bcf-d1d616c59607 -Role Member
13
Takım içerisinde bulunan üye yetkisine sahip kullanıcıların listesini alır.
Tüm Üyeler İçin Mesajlaşma Yetkilerini Görüntüleme
Get-TeamMessagingSettings -GroupId 08bc065e-feb8-410f-8bcf-d1d616c59607
İlgili takım içerisinde kullanıcılar için mesaşlaşma yetkilerinin görüntülenmesini sağlar.
Tüm Üyeler İçin Mesajlaşma Yetkilerinin Değiştirilmesi
Set-TeamMessagingSettings -GroupId 08bc065e-feb8-410f-8bcf-d1d616c59607 -AllowUserEditMessages false
Mevcut kullanıcı mesajlaşma yetkilerinin değiştirilmesini sağlar.
Sonuç olarak AllowUserEditMessages yetkisinin tüm kullanıcılar için değiştirildiğini görebiliriz.
Konuk Kullanıcıların Yetkilerini Görüntüleme
Get-TeamGuestSettings -GroupId 08bc065e-feb8-410f-8bcf-d1d616c59607
14
Takım içerisinde konuk kullanıcıların yetkilerini görüntüler.
Konuk Kullanıcıların Yetkilerinin Değiştirilmesi
Set-TeamGuestSettings -GroupId 08bc065e-feb8-410f-8bcf-d1d616c59607 -AllowCreateUpdateChannels true -AllowDeleteChannels true
Takım içerisinde bulunan konuk kullanıcıların yetkilerinin değiştirilmesini sağlar.
Sonuç olarak konuk kullanıcılarımız için yetkilerin değiştirilmesini sağlamış olduk. (Önerilmez)
Böylece PowerShell ile Microsoft Teams kitabımızı bitirmiş olduk.
Kaynaklar
Microsoft Teams PowerShell
https://docs.microsoft.com/en-us/powershell/module/teams/?view=teams-ps
https://docs.microsoft.com/en-us/powershell/module/teams/?view=teams-ps