SharePoint Online: PowerShell kullanarak Yeni Liste Öğesi Ekleme

Gereksinim: SharePoint Online ile çalışırken, PowerShell betiğinden bir listeye yeni liste öğeleri ekleme zorunluluğum vardı. Bu blog gönderisinde bazı örneklerle PowerShell kullanılarak SharePoint Online'da nasıl liste öğesi oluşturulacağı ele alınacaktır.

SharePoint Online'da bir Listeye nasıl öğe eklenir?

SharePoint listelerine öğe eklemek, muhtemelen kendinizi düzenli olarak yaparken bulacağınız yaygın bir görevdir. İşte bunun nasıl yapılacağına dair hızlı bir genel bakış:

  1. SharePoint sitenizde oturum açın ve öğe eklemek istediğiniz listeye gidin.
  2. Komut çubuğundan “+ Yeni” bağlantısına tıklayın.
  3. Yeni öğenin bilgilerini uygun alanlara girin.

  4. “Kaydet” düğmesine tıklayın.

Ve hepsi bu kadar! PowerShell kullanarak SharePoint çevrimiçi listesine nasıl öğe ekleneceğini görelim.

SharePoint Online: Liste Öğesi Eklemek için PowerShell

SharePoint Online'ınızdaki web tabanlı kullanıcı arabirimini kullanmadan, SharePoint Online'da bir liste öğesi oluşturmak isteyebileceğiniz birçok durum vardır. Neyse ki bunu PowerShell kullanarak yapmanın kolay bir yolu var. Bu blog yazısında, PowerShell kullanarak SharePoint Online listesine nasıl öğe ekleyeceğinizi göstereceğiz.

PowerShell kullanarak bir liste öğesi eklemek için listedeki her özel sütunun değerini ayarlamamız gerekir. Bir liste öğesi oluşturmak için SharePoint Online PowerShell'i burada bulabilirsiniz:


#Load SharePoint CSOM Assemblies
Add-Type -Path "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\ISAPI\Microsoft.SharePoint.Client.dll"
Add-Type -Path "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\ISAPI\Microsoft.SharePoint.Client.Runtime.dll"

#Set Config Parameters
$SiteURL="https://Crescent.sharepoint.com"
$ListName="Tasks"

Try { 
    #Get Credentials to connect
    $Cred= Get-Credential
 
    #Setup the context
    $Ctx = New-Object Microsoft.SharePoint.Client.ClientContext($SiteURL)
    $Ctx.Credentials = New-Object Microsoft.SharePoint.Client.SharePointOnlineCredentials($Cred.Username, $Cred.Password)
 
    #Get the List
    $List=$Ctx.Web.Lists.GetByTitle($ListName)
 
    #sharepoint online powershell add list item
    $ListItemInfo = New-Object Microsoft.SharePoint.Client.ListItemCreationInformation  
    $ListItem = $List.AddItem($ListItemInfo)
    
    #Set Column Values
    $ListItem["Title"] = "Project Darwin"

    #Set People Picker Field value
    $AssignedToUser = $Ctx.web.EnsureUser("Salaudeen@TheCrescentTech.com")
    $ListItem["AssignedTo"] = $AssignedToUser
    
    #Set Date Fields
    $ListItem["StartDate"] = "01/07/2015"
    $ListItem["DueDate"] = "01/08/2015"
    
    #Set Percentage Field 
    $ListItem["PercentComplete"] = "0.2" #20%

    #add item to sharepoint online list powershell
    $ListItem.Update()
    $Ctx.ExecuteQuery()
 
    Write-host -f Green "New Item has been added to the List!"
}
Catch {
    write-host -f Red "Error:" $_.Exception.Message
}

Bu, Görevler listesine yeni bir öğe ekler. Bu, web tarayıcısı kullanıcı arayüzünü kullanmak zorunda kalmadan PowerShell kullanarak SharePoint Online'daki listeye öğe eklemenin hızlı ve kolay bir yoludur. İşte sonuç:

Liste Öğesi Oluşturmak için SharePoint Çevrimiçi PowerShell

Bazı hata işleme kodları ekleyelim ve komut dosyasındaki çalışma zamanında kimlik bilgilerini alalım. Liste öğeleri eklemek için SharePoint Online PowerShell CSOM'u burada bulabilirsiniz:


#Load SharePoint CSOM Assemblies
Add-Type -Path "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\ISAPI\Microsoft.SharePoint.Client.dll"
Add-Type -Path "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\ISAPI\Microsoft.SharePoint.Client.Runtime.dll"

#Config Parameters
$SiteURL="https://crescent.sharepoint.com"
$ListName="Random"
$ItemsToCreate="1000"

Try {
    $Cred= Get-Credential
    $Credentials = New-Object Microsoft.SharePoint.Client.SharePointOnlineCredentials($Cred.Username, $Cred.Password)

    #Setup the context
    $Ctx = New-Object Microsoft.SharePoint.Client.ClientContext($SiteURL)
    $Ctx.Credentials = $Credentials
        
    #Get the List
    $List = $Ctx.Web.Lists.GetByTitle($ListName)
    $Ctx.Load($List)
    $Ctx.ExecuteQuery()

    #add an item to list SharePoint Online PowerShell - with Random Data
    For($i=1; $i -le $ItemsToCreate; $i++)
    {
        #create list item in sharepoint online using powershell
        $ListItemInfo = New-Object Microsoft.SharePoint.Client.ListItemCreationInformation
        $ListItem = $List.AddItem($ListItemInfo)
        $ListItem["Title"] = $I
        $ListItem.Update()
        $Ctx.ExecuteQuery()

        Write-host "New Item $I Added to the List!" -ForegroundColor Green  
    }
}
Catch {
    write-host -f Red "Error Adding Items to List!" $_.Exception.Message
}

Bu komut dosyası, liste öğelerini toplu olarak rastgele oluşturur.

PnP PowerShell, SharePoint Online'a Liste Öğesi Ekleyecek

SharePoint Online ile çalışırken listeye program aracılığıyla bir öğe eklemeniz gerekebilir. Neyse ki PowerShell kullanarak bunu başarmanın kolay bir yolu var. Düzenli olarak veya gözetimsiz eklenmesi gereken içerik oluşturmayı otomatikleştirmeye yardımcı olması için PowerShell betiğini kullanabilirsiniz.

PnP PowerShell cmdlet'i Add-PnPListItem ile SharePoint Online'daki listeye nasıl öğe ekleyeceğiniz aşağıda açıklanmıştır.

  1. İlk adım, SharePoint Online sitenizin URL'sine bağlanmaktır. Bunu şu cmdlet'i çalıştırarak yapabilirsiniz: Connect-PnPOnline.
  2. Bağlandıktan sonra listenize öğe eklemek için Add-PnPListItem cmdlet'ini kullanabilirsiniz. Örneğin, aşağıdaki komut Internal name alanını ve alanın değerini içeren bir listeye yeni bir öğe ekleyecektir: Add-PnPlistItem -list “List Name” -values @{“Field Internal Name”=”Field Value”; “Alan Dahili Adı”=”Alan Değeri”}

İşte bir örnek:


#Config Variables
$SiteURL = "https://Crescent.sharepoint.com"
$ListName ="Projects"

#Connect to PnP Online
Connect-PnPOnline -Url $SiteURL -Interactive

#Add List Item - Internal Names of the columns: Value
Add-PnPListItem -List $ListName -Values @{"Title" = "SharePoint 2016 Migration V2"; "ProjectID"="Abj-IT-3025"}

Belirli bir içerik türünden bir öğe eklemek istiyorsanız “ContentType” parametresini ad veya kimlikle de belirtebilirsiniz. Bu PowerShell betiğini çalıştırdığınızda listeye yeni bir öğe eklenecektir. PowerShell kullanarak SharePoint Online listelerine öğe eklemek, verilerinizi doldurmanın hızlı ve kolay bir yoludur.

Yönetilen meta veriler, Köprü, Arama, Kişi veya Grup vb. gibi Alanları Ayarlamaya ne dersiniz?

Yukarıdaki komut dosyaları, tek satırlık metin, seçim, Evet/Hayır vb. gibi basit alan türleriyle gayet iyi çalışır. Ancak, Yönetilen meta veriler, Köprü, Arama, Kişi Seçici vb. gibi diğer alan türleri için bunları farklı şekilde ele almamız gerekir. İşte yardımcı olacak gönderilerim:

  • SharePoint Online: PowerShell, Arama Alanı Değerini Güncelleştirecek
  • SharePoint Online: PowerShell'i kullanarak Köprü Alanı Değerini Güncelleyin
  • SharePoint Online: PowerShell, Arama Alanı Değerini Güncelleştirecek
  • SharePoint Online: PowerShell'i kullanarak Yönetilen Meta Veri Alanı Değerini Güncelleyin
  • SharePoint Online: PowerShell'i kullanarak Kişi veya Grup Alan Değerlerini Güncelleyin
  • SharePoint Online: PowerShell'i kullanarak Seçim Alanı Değerini Güncelleyin
  • SharePoint Online: PowerShell'i kullanarak "Evet/Hayır (Onay kutusu)" Alan Değerini Güncelleyin
  • SharePoint Online: PowerShell Tarih Alanı Değerini Güncelleştirecek

Sıkça Sorulan Sorular:

SharePoint Online'da Toplu Olarak Birden Çok Liste öğesini nasıl eklerim?

PnP PowerShell'deki New-PnPBatch cmdlet'ini kullanarak silme gibi toplu işlemleri gerçekleştirebilir veya SharePoint Online listesine toplu olarak öğe ekleyebilirsiniz.
Daha fazla bilgi: PowerShell Kullanarak Toplu Olarak Birden Çok Liste Öğesi Nasıl Eklenir?

Verileri CSV'den SharePoint Online listesine nasıl aktarırım?

Bir CSV dosyasından veya Excel'den bir liste oluşturabilseniz de, PowerShell'deki Import-CSV ve Add-PnPList öğe cmdlet'leri ile art arda içe aktarmalar gerçekleştirilebilir.
Daha fazla bilgi: CSV'yi SharePoint çevrimiçi listesine aktarın PowerShell

SharePoint Online PowerShell'e nasıl dosya yüklerim?

PowerShell kullanarak SharePoint belge kitaplığına bir dosya yüklemek için CSOM'da Files.Add yöntemini veya PnP PowerShell'den Add-PnPFile cmdlet'ini kullanın.
Daha fazla bilgi: PowerShell kullanarak dosyaları SharePoint Online'a yükleyin

PowerShell'deki SharePoint Online listesindeki öğeleri nasıl alabilirim?

SharePoint Online'dan liste öğelerini sorgulamak ve almak için "List.GetItems" yöntemini veya PnP PowerShell'den Get-PnPListItem'i kullanın.
Daha fazla bilgi: SharePoint Online Liste öğelerini alma PowerShell

İlgili makaleler