Add-SPOTheme

Modulo:

Microsoft.Online.SharePoint.PowerShell

Si applica a:

SharePoint Online

Crea un nuovo tema personalizzato o sovrascrive un tema esistente per modificarne le impostazioni.

Sintassi

Add-SPOTheme
   -Identity <SpoThemePipeBind>
   -IsInverted <bool>
   -Overwrite
   -Palette <SpoThemePalettePipeBind> 
   [<CommonParameters>]

Descrizione

Il cmdlet Add-SPOTheme crea un nuovo tema o aggiorna un tema esistente. Le impostazioni della tavolozza dei colori possono essere passate come tabella hash o come dizionario.

L'aggiunta di un tema non applica il tema ad alcun sito. Aggiunge il tema all'archivio tenant e quindi il tema è disponibile nell'elenco dei temi nell'opzione Cambia aspetto per le pagine moderne.

Esempio

Esempio 1

In questo esempio viene creato un nuovo tema denominato "Custom Cyan" , con le impostazioni della tavolozza dei colori che sono varie sfumature di ciano. Si noti che le impostazioni vengono passate come tabella hash.

$themepalette = @{
  "themePrimary" = "#00ffff";
  "themeLighterAlt" = "#f3fcfc";
  "themeLighter" = "#daffff";
  "themeLight" = "#affefe";
  "themeTertiary" = "#76ffff";
  "themeSecondary" = "#39ffff";
  "themeDarkAlt" = "#00c4c4";
  "themeDark" = "#009090";
  "themeDarker" = "#005252";
  "neutralLighterAlt" = "#f8f8f8";
  "neutralLighter" = "#f4f4f4";
  "neutralLight" = "#eaeaea";
  "neutralQuaternaryAlt" = "#dadada";
  "neutralQuaternary" = "#d0d0d0";
  "neutralTertiaryAlt" = "#c8c8c8";
  "neutralTertiary" = "#a6a6a6";
  "neutralSecondaryAlt" = "#767676";
  "neutralSecondary" = "#666666";
  "neutralPrimary" = "#333";
  "neutralPrimaryAlt" = "#3c3c3c";
  "neutralDark" = "#212121";
  "black" = "#000000";
  "white" = "#fff";
  "primaryBackground" = "#fff";
  "primaryText" = "#333"
 }

Add-SPOTheme -Identity "Custom Cyan" -Palette $themepalette -IsInverted $false

Nota

Prima della versione di dicembre 2017 di SPO Management Shell, il cmdlet Add-SPOTheme richiedeva il passaggio delle impostazioni della tavolozza dei colori come dizionario. È consigliabile usare la versione più recente di SPO Management Shell oppure usare la HashToDictionary funzione per convertire una tabella hash in un dizionario, se necessario.

Esempio 2

Se si vuole aggiornare un tema esistente (per modificare alcune delle relative impostazioni di colore, ad esempio), usare la stessa sintassi illustrata in precedenza, ma aggiungere il -Overwrite flag al cmdlet Add-SPOTheme .

Add-SPOTheme -Identity "Custom Cyan" -Palette $themepalette -IsInverted $false -Overwrite

Parametri

-Identity

Specifica il nome del tema. Questo deve identificare in modo univoco il tema.

Type:	SpoThemePalettePipeBind
Aliases:	Name
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

-IsInverted

Specifica se il tema è invertito, con uno sfondo scuro e un primo piano chiaro.

Type:	Boolean
Aliases:	None
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

-Overwrite

Sovrascrive un tema con lo stesso nome nel caso in cui esista.

Type:	SwitchParameter
Aliases:	None
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

-Palette

Specifica la tavolozza dei colori nel tema, come dizionario dei valori dello slot del tema.

Type:	SpoThemePalettePipeBind
Aliases:	None
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online