Weboldal keresés

SharePoint Online: Hozzon létre egy kifejezést a Term Store-ban a PowerShell segítségével

Követelmény: Hozzon létre egy kifejezést a SharePoint Online Term Store-ban.

Hogyan adhat hozzá kifejezést a SharePoint Online Term Store-ban?

A SharePoint Online tárolása kifejezés lehetővé teszi az adatok kategorizálását és szabványosítását. Kategóriákat határozhat meg, és adatait osztályozáshoz címkézheti kifejezések, kifejezéskészletek és kifejezéscsoportok formájában. Ha új kifejezést szeretne létrehozni a SharePoint Online kifejezéstárban, kövesse az alábbi lépéseket:

  1. Keresse meg a SharePoint felügyeleti központ webhelyét. (Pl. https://tenant-admin.sharepoint.com)
  2. Kattintson a „terméktár” linkre a bal oldali navigációs menüben. (A Modern SharePoint Felügyeleti Központban válassza ki a Klasszikus funkciókat, majd kattintson a „Megnyitás” gombra a Term store alatt.)

  3. Bontsa ki és keresse meg azt a kifejezéskészletet, amelyhez új kifejezést szeretne hozzáadni. Kattintson a kis nyílra a kifejezéskészlet fejlécében >> Kattintson a „Kifejezés létrehozása” lehetőségre.

  4. Kezdje el beírni az új kifejezést, és nyomja meg az Enter billentyűt a kifejezés létrehozásának befejezéséhez.

Több kifejezés hozzáadásához egyszerűen nyomja meg az ENTER billentyűt minden kifejezés után. A kifejezés létrehozása után további tulajdonságokat adhat meg az új kifejezéshez. Például Leírás, Címkézésre elérhető, Nyelv stb., a tulajdonságok ablaktáblában, majd kattintson a Mentés gombra, ha elkészült.

PowerShell új kifejezés hozzáadásához a SharePoint Online Term Store-ban:

Tehát valószínűleg automatizálni szeretné azt a feladatot, hogy a PowerShell segítségével kifejezéseket adjon hozzá a SharePoint Online Term Store-hoz. A következőképpen adhat hozzá kifejezéseket a PnP PowerShell használatával:


#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"
Add-Type -Path "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\ISAPI\Microsoft.SharePoint.Client.Taxonomy.dll"
  
#Variables for Processing
$AdminURL = "https://crescent-admin.sharepoint.com/"
$TermGroupName ="Regions"
$TermSetName="MENA"
$TermName="United Arab Emirates"

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

    #Setup the context
    $Ctx = New-Object Microsoft.SharePoint.Client.ClientContext($AdminURL)
    $Ctx.Credentials = $Credentials

    #Get the term store
    $TaxonomySession=[Microsoft.SharePoint.Client.Taxonomy.TaxonomySession]::GetTaxonomySession($Ctx) 
    $TermStore =$TaxonomySession.GetDefaultSiteCollectionTermStore()
    $Ctx.Load($TaxonomySession)
    $Ctx.Load($TermStore)
    $Ctx.ExecuteQuery()

    #Get the Term Group    
    $TermGroup = $TermStore.Groups.GetByName($TermGroupName)
    $Ctx.Load($TermGroup)

    #Get the Term Set
    $TermSet = $TermGroup.TermSets.GetByName($TermSetName)
    $Ctx.Load($TermSet)

    #Check if the given term exists already
    $Terms = $TermSet.Terms
    $Ctx.Load($Terms)
    $Ctx.ExecuteQuery()
    $Term = $Terms | Where-Object {$_.Name -eq $TermName}
    
    If(-not $Term)
    {
        #Create Term
        $NewTerm = $TermSet.CreateTerm($TermName,1033,[System.Guid]::NewGuid().toString())
        $Ctx.Load($NewTerm)
        $Ctx.ExecuteQuery()
    
        Write-host "New Term '$TermName' Created Successfully!" -ForegroundColor Green
    }
    else
    {
        Write-host "Term '$TermName' Exists Already!" -ForegroundColor Yellow
    }
}
Catch {
    write-host -f Red "Error Creating Term!" $_.Exception.Message
}

PowerShell több kifejezés hozzáadásához a SharePoint Online kifejezéskészletéhez:

A fenti szkript egyetlen kifejezést ad hozzá a kifejezéstárban lévő adott kifejezéskészlethez. Adjunk hozzá több kifejezést egy kifejezéskészlethez.


#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"
Add-Type -Path "C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\16\ISAPI\Microsoft.SharePoint.Client.Taxonomy.dll"
  
#Variables for Processing
$AdminURL = "https://crescent-admin.sharepoint.com/"
$TermGroupName ="Regions"
$TermSetName="MENA"
$TermsToAdd =@("Bahrain", "Egypt", "Iran", "Iraq", "Jordan", "Kuwait", "Lebanon", "Oman", "Palestine", "Qatar", "Saudi Arabia", "Syria", "Turkey", "United Arab Emirates", "Yemen")

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

    #Setup the context
    $Ctx = New-Object Microsoft.SharePoint.Client.ClientContext($AdminURL)
    $Ctx.Credentials = $Credentials

    #Get the term store
    $TaxonomySession=[Microsoft.SharePoint.Client.Taxonomy.TaxonomySession]::GetTaxonomySession($Ctx) 
    $TermStore =$TaxonomySession.GetDefaultSiteCollectionTermStore()
    $Ctx.Load($TaxonomySession)
    $Ctx.Load($TermStore)
    $Ctx.ExecuteQuery()

    #Get the Term Group    
    $TermGroup = $TermStore.Groups.GetByName($TermGroupName)
    $Ctx.Load($TermGroup)

    #Get the Term Set
    $TermSet = $TermGroup.TermSets.GetByName($TermSetName)
    $Ctx.Load($TermSet)

    #Create Terms
    Foreach ($TermName in $TermsToAdd)
    {
        #Check if the given term exists already
        $Terms = $TermSet.Terms
        $Ctx.Load($Terms)
        $Ctx.ExecuteQuery()
        $Term = $Terms | Where-Object {$_.Name -eq $TermName}
    
        If(-not $Term)
        {
            #Create new Term
            $NewTerm = $TermSet.CreateTerm($TermName,1033,[System.Guid]::NewGuid().toString())
            $Ctx.ExecuteQuery()
            $TermStore.CommitAll()
    
            Write-host "New Term '$TermName' Added Successfully!" -ForegroundColor Green
        }
        else
        {
            Write-host "Term '$TermName' Exists Already!" -ForegroundColor Yellow
        }
    }
}
Catch {
    write-host -f Red "Error Creating Term!" $_.Exception.Message
}

SharePoint Online: Hozzon létre kifejezést a PnP PowerShell használatával

Használjuk a PnP PowerShellt egy kifejezés hozzáadására a SharePoint Online kifejezéskészletéhez:


#Config Variables
#$SiteURL = "https://Crescent.sharepoint.com"
$AdminCenterURL = "https://Crescent-admin.sharepoint.com"
$TermGroupName = "Regions"
$TermSetName = "MENA"
$TermName="United Arab Emirates"

#Connect to PnP Online
Connect-PnPOnline -Url $SiteURL -Credentials (Get-Credential)

#Check if Term exists
If(-Not(Get-PnPTerm -Identity $TermName -TermSet $TermSetName -TermGroup $TermGroupName -ErrorAction SilentlyContinue))
{
    #Create new Term
    New-PnPTerm -Name $TermName -TermSet $TermSetName -TermGroup $TermGroupName
}
Else
{
    Write-host -f Yellow "Term '$TermName' already exists!"
}

Mi a teendő, ha az adott kifejezéscsoport vagy kifejezéskészlet nem létezik? Nos, tévedésben lesz része! Tehát a következőképpen mérsékelheti: A következő PnP PowerShell importálja a Term tárolási adatokat. Kifejezéscsoportot, kifejezéskészletet és kifejezéseket hoz létre (ha még nem léteznek!)


#Config Variables
$AdminCenterURL = "https://Crescent-admin.sharepoint.com"
$Taxonomy= "Deals Pipeline|Regions|South America" #Format: Term Group|Termset|Term

#Connect to PnP Online
Connect-PnPOnline -Url $AdminCenterURL -Credentials (Get-Credential)

#Import Term store Group, Term Set and Terms
Import-PnPTaxonomy -Terms $Taxonomy

Az Import-PnPTaxonomy támogatja az importálást tömbökből és akár szöveges fájlokból is! Például.,


$Taxonomy= "Deals Pipeline|Regions|Africa","Deals Pipeline|Regions|South America","Deals Pipeline|Regions|North America"

Összefoglalva, egy kifejezést a SharePoint Online-ban a felhasználói felületen vagy a PowerShell-en keresztül lehet létrehozni. Könnyen létrehozhat egy kifejezést és meghatározhatja tulajdonságait a fenti módszerekkel. A feltételek a SharePoint Online felügyelt metaadatszolgáltatásának fontos részét képezik, és a tartalom osztályozására és rendszerezésére használhatók.

Kapcsolódó cikkek