Prerequesites:
You need to have the PnP Powershell module installed to use the pnp powershell commands as described in this article.

소개

대부분의 회사는 SharePoint Online에서 자체 브랜드 색상을 사용하여 직원들에게 멋지고 친숙하게 보이도록 만들고 싶어합니다. 이 사용자 정의 색상 테마 때문에 모든 MS365 개발자가 편안하게 느껴야 하는 주제입니다. 또한 매우 간단합니다.

이 블로그 게시물에서는 PNP-powershell을 사용하여 사용자 지정 색상 팔레트를 만드는 방법, 테넌트 전체에서 테마를 사용할 수 있게 하는 방법, 특정 사이트에서 테마를 설정하는 방법을 보여줍니다.

Note, to change the color of the suitebar/navigationbar (the top bar that follows you around MS365 not just in SharePoint Online) you can do so in the admin-center. Go to Admin –> Settings –> Org Settings –> Organization profile and select Custom Themes.

시작하기 전에 CLI(명령줄 인터페이스)를 열고 테넌트 관리 사이트에 연결해야 합니다. 도메인 끝에 "-admin"을 추가하면 됩니다. 내 테넌트에서 MFA(다단계 인증)를 활성화했기 때문에 -Interactive 매개 변수도 사용합니다.
//Log in to your tenant
Connect-PnPOnline "https://yourtenant-admin.sharepoint.com" -Interactive

사용자 지정 색상 팔레트 만들기

테넌트에 사용 가능한 사용자 지정 테마가 이미 있는지 확실하지 않은 경우 명령Get-PnPTenantTheme을 사용하여 사용 가능한 테마 목록을 가져올 수 있습니다.


이 명령이 아무 것도 반환하지 않으면 테넌트에 사용자 지정 테마가 없는 것입니다. 기본 SharePoint 테마는 이 목록에 표시되지 않습니다.

위 그림과 같이 테마가 여러 개인 경우 명령에 테마 이름을 추가하여 원하는 테마를 지정할 수 있습니다. -asJSon 플래그를 추가하여 색상 팔레트를 복사할 수 있는 json 문자열로 가져옵니다.
//Get a specific theme by name, and as JSON
Get-PnPTenantTheme "Elis main theme" -asJson

도구를 사용하여 색상 팔레트 만들기

편집할 사용자 정의 테마가 없거나 색상 팔레트를 만들 때 시각적 도움이 필요한 경우 Fluent UI Theme designer 과 같은 도구를 사용할 수 있습니다. 이 도구는 선택한 색상이 wcag 접근성 표준을 유지하는지 여부도 알려주기 때문에 특히 마음에 듭니다.

This article in the Microsoft docs에서는 SharePoint에서 일반적으로 사용되는 다양한 색상 변수에 대한 멋진 개요를 제공합니다.

테넌트에서 새 테마를 사용할 수 있도록 설정

팔레트를 만들었으면 테넌트에서 사용할 수 있도록 할 시간입니다. 색상 팔레트를 포함하는 변수를 만듭니다. 아래와 같이 Add-PnPTenantTheme 명령을 실행할 때 이 변수를 사용합니다.

$color_palette = @{
         "themePrimary" = "#874070";
         "themeLighterAlt" = "#faf5f9";
         "themeLighter" = "#ecd8e5";
         "themeLight" = "#dbb8d0";
      "themeTertiary" = "#b77da5";
      "themeSecondary" = "#96507f";
      "themeDarkAlt" = "#7a3965";
      "themeDark" = "#673055";
      "themeDarker" = "#4c243f";
      "neutralLighterAlt" = "#faf9f8";
      "neutralLighter" = "#f3f2f1";
      "neutralLight" = "#edebe9";
      "neutralQuaternaryAlt" = "#e1dfdd";
      "neutralQuaternary" = "#d0d0d0";
      "neutralTertiaryAlt" = "#c8c6c4";
      "neutralTertiary" = "#a19f9d";
      "neutralSecondary" = "#605e5c";
      "neutralPrimaryAlt" = "#3b3a39";
      "neutralPrimary" = "#323130";
      "neutralDark" = "#201f1e";
      "black" = "#000000";
      "white" = "#ffffff";
}

Add-PnPTenantTheme -Identity "Elis Main Theme" -Palette $color_palette -IsInverted $false

사이트에 테마 추가

“Get-PnPTenantTheme”를 다시 실행하면 목록에서 테마를 볼 수 있습니다. UI를 통해서도 찾을 수 있습니다. SharePoint 사이트로 이동하여 "모양 변경"/"테마"를 선택하면 목록에 새 테마가 표시됩니다.


이제 powershell을 사용하여 사이트에 테마를 추가해 보겠습니다. Set-PnPWebTheme 명령을 사용하고 테마 이름과 사이트의 webUrl을 매개 변수로 추가하여 이 작업을 수행합니다.
Set-PnPWebTheme -Theme "Elis Main Theme" -WebUrl "https://yourtenant.sharepoint.com/sites/ThemeTestSite"

요약

이 블로그 게시물에서는 PnP powershell을 사용하여 SharePoint Online 테넌트에 사용자 지정 색상 테마를 만들고 추가하는 방법을 보여 주었습니다. 이 정보가 도움이 되었기를 바랍니다.