Add-SPOTheme
Crea un nuovo tema personalizzato o sovrascrive un tema esistente per modificarne le impostazioni.
Sintassi
NewThemeSet
Add-SPOTheme
[-Identity] <SpoThemePipeBind>
-ColorPairs <SpoThemeColorPairPipeBind>
[-Overwrite]
[<CommonParameters>]
LegacyThemeSet
Add-SPOTheme
[-Identity] <SpoThemePipeBind>
-Palette <SpoThemePalettePipeBind>
-IsInverted <Boolean>
[-Overwrite]
[<CommonParameters>]
Descrizione
Questo cmdlet crea un nuovo tema o aggiorna un tema esistente. Le impostazioni delle coppie di colori possono essere passate come tabella hash, mentre le impostazioni della tavolozza dei colori possono essere passate come tabella hash o dizionario.
L'aggiunta di un tema non lo applica automaticamente ad alcun sito. Al contrario, il tema diventa disponibile nell'elenco dei temi sotto l'opzione Cambia aspetto per le pagine moderne di SharePoint.
Scegli il set di parametri appropriato in base al fatto che tu stia lavorando con un formato di tema legacy o moderno. Per maggiori dettagli sul nuovo formato del tema, consultate Tema del sito.
Nota
Negli ambienti con più aree geografiche, i temi aggiunti da un amministratore nell'area geografica principale vengono automaticamente propagati e disponibili in tutta l'organizzazione. Questo cmdlet non è supportato per gli amministratori nelle aree geografiche satellite.
Esempio
Esempio 1:
$colorPairs = @{
light = @(
@{ "accentColor" = "#007780"; "backgroundColor" = "#FFFFFF" }
@{ "accentColor" = "#FFFFFF"; "backgroundColor" = "#007780" }
@{ "accentColor" = "#E3FFFD"; "backgroundColor" = "#007780" }
@{ "accentColor" = "#007780"; "backgroundColor" = "#E3FFFD" }
@{ "accentColor" = "#FFF9E3"; "backgroundColor" = "#007780" }
@{ "accentColor" = "#007780"; "backgroundColor" = "#FFF9E3" }
@{ "accentColor" = "#007780"; "backgroundColor" = "#F5F5F5" }
@{ "accentColor" = "#242424"; "backgroundColor" = "#F5F5F5" }
@{ "accentColor" = "#155473"; "backgroundColor" = "#FFFFFF" }
@{ "accentColor" = "#FFFFFF"; "backgroundColor" = "#155473" }
@{ "accentColor" = "#155473"; "backgroundColor" = "#E3FFFD" }
@{ "accentColor" = "#E3FFFD"; "backgroundColor" = "#155473" }
@{ "accentColor" = "#FFF9E3"; "backgroundColor" = "#155473" }
@{ "accentColor" = "#155473"; "backgroundColor" = "#FFF9E3" }
)
}
Add-SPOTheme -Identity "Teal Theme" -ColorPairs $colorPairs
In questo esempio viene creato un tema denominato "Teal Theme" con coppie di colori impostazioni in varie tonalità di verde acqua.
Esempio 2:
Add-SPOTheme -Identity "Teal Theme" -ColorPairs $colorPairs -Overwrite
Per aggiornare un tema esistente nel nuovo formato, modifica le impostazioni del colore utilizzando la stessa sintassi utilizzata durante la creazione di un tema. Aggiungere il -Overwrite contrassegno al cmdlet Add-SPOTheme.
Esempio 3:
$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
In questo esempio viene creato un tema denominato "Custom Cyan" , con impostazioni della tavolozza dei colori di varie tonalità di ciano. Si noti che le impostazioni vengono passate come tabella hash.
Nota
Prima della versione di dicembre 2017 di SPO Management Shell, il cmdlet Add-SPOTheme richiedeva che le impostazioni della tavolozza dei colori fossero passate come dizionario. È consigliabile usare la versione più recente di SharePoint Online Management Shell o usare la HashToDictionary funzione per convertire una tabella hash in un dizionario, se necessario.
Esempio 4: Sovrascrivere un tema di formato legacy
Add-SPOTheme -Identity "Custom Cyan" -Palette $themepalette -IsInverted $false -Overwrite
Per aggiornare un tema di formato legacy esistente e modificarne le impostazioni di colore, utilizzare la stessa sintassi utilizzata durante la creazione del tema. Aggiungere il -Overwrite contrassegno al cmdlet Add-SPOTheme.
Parametri
-ColorPairs
Applicabile: SharePoint Online
Specifica le coppie di colori del tema utilizzando una tabella hash di valori di slot. Supporta fino a 16 coppie di colori.
Proprietà dei parametri
| Tipo: | Microsoft.Online.SharePoint.PowerShell.SpoThemeColorPairPipeBind |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
NewThemeSet
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Identity
Applicabile: SharePoint Online
Specifica il nome del tema. Deve identificare in modo univoco il tema.
Proprietà dei parametri
| Tipo: | Microsoft.Online.SharePoint.PowerShell.SpoThemePipeBind |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Nome |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-IsInverted
Applicabile: SharePoint Online
Specifica se il tema è invertito, con uno sfondo scuro e un primo piano chiaro.
Proprietà dei parametri
| Tipo: | System.Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Nessuno |
Set di parametri
LegacyThemeSet
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Overwrite
Applicabile: SharePoint Online
Sovrascrive un tema con lo stesso nome nel caso in cui esista.
Proprietà dei parametri
| Tipo: | System.Management.Automation.SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Nessuno |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Palette
Applicabile: SharePoint Online
Specifica la tavolozza di colori nel tema, come un dizionario o una tabella hash di valori di slot del tema.
Proprietà dei parametri
| Tipo: | Microsoft.Online.SharePoint.PowerShell.SpoThemePalettePipeBind |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
LegacyThemeSet
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.