Condividi tramite


Set-CMBaseline

Modificare le impostazioni delle baseline di configurazione.

Sintassi

Set-CMBaseline
   [-AddBaseline <String[]>]
   [-AddCategory <String[]>]
   [-AddOptionalConfigurationItem <String[]>]
   [-AddOSConfigurationItem <String[]>]
   [-AddProhibitedConfigurationItem <String[]>]
   [-AddRequiredConfigurationItem <String[]>]
   [-AddSoftwareUpdate <String[]>]
   [-AllowComanagedClients <Boolean>]
   [-ClearBaseline]
   [-ClearOptionalConfigurationItem]
   [-ClearOSConfigurationItem]
   [-ClearProhibitedConfigurationItem]
   [-ClearRequiredConfigurationItem]
   [-ClearSoftwareUpdate]
   [-Description <String>]
   [-DesiredConfigurationDigestPath <String>]
   -Id <Int32>
   [-NewName <String>]
   [-PassThru]
   [-RemoveBaseline <String[]>]
   [-RemoveCategory <String[]>]
   [-RemoveOptionalConfigurationItem <String[]>]
   [-RemoveOSConfigurationItem <String[]>]
   [-RemoveProhibitedConfigurationItem <String[]>]
   [-RemoveRequiredConfigurationItem <String[]>]
   [-RemoveSoftwareUpdate <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMBaseline
   [-AddBaseline <String[]>]
   [-AddCategory <String[]>]
   [-AddOptionalConfigurationItem <String[]>]
   [-AddOSConfigurationItem <String[]>]
   [-AddProhibitedConfigurationItem <String[]>]
   [-AddRequiredConfigurationItem <String[]>]
   [-AddSoftwareUpdate <String[]>]
   [-AllowComanagedClients <Boolean>]
   [-ClearBaseline]
   [-ClearOptionalConfigurationItem]
   [-ClearOSConfigurationItem]
   [-ClearProhibitedConfigurationItem]
   [-ClearRequiredConfigurationItem]
   [-ClearSoftwareUpdate]
   [-Description <String>]
   [-DesiredConfigurationDigestPath <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveBaseline <String[]>]
   [-RemoveCategory <String[]>]
   [-RemoveOptionalConfigurationItem <String[]>]
   [-RemoveOSConfigurationItem <String[]>]
   [-RemoveProhibitedConfigurationItem <String[]>]
   [-RemoveRequiredConfigurationItem <String[]>]
   [-RemoveSoftwareUpdate <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMBaseline
   [-AddBaseline <String[]>]
   [-AddCategory <String[]>]
   [-AddOptionalConfigurationItem <String[]>]
   [-AddOSConfigurationItem <String[]>]
   [-AddProhibitedConfigurationItem <String[]>]
   [-AddRequiredConfigurationItem <String[]>]
   [-AddSoftwareUpdate <String[]>]
   [-AllowComanagedClients <Boolean>]
   [-ClearBaseline]
   [-ClearOptionalConfigurationItem]
   [-ClearOSConfigurationItem]
   [-ClearProhibitedConfigurationItem]
   [-ClearRequiredConfigurationItem]
   [-ClearSoftwareUpdate]
   [-Description <String>]
   [-DesiredConfigurationDigestPath <String>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-RemoveBaseline <String[]>]
   [-RemoveCategory <String[]>]
   [-RemoveOptionalConfigurationItem <String[]>]
   [-RemoveOSConfigurationItem <String[]>]
   [-RemoveProhibitedConfigurationItem <String[]>]
   [-RemoveRequiredConfigurationItem <String[]>]
   [-RemoveSoftwareUpdate <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Usare questo cmdlet per modificare le impostazioni di una baseline di configurazione in Configuration Manager. Una baseline di configurazione può includere i tipi di dati di configurazione seguenti:

  • Elementi di configurazione
  • Altre baseline di configurazione
  • Aggiornamenti software

Il client di Configuration Manager valuta la conformità rispetto a questa baseline. Se tutti gli elementi specificati sono conformi, la baseline stessa viene valutata come conforme. È anche possibile includere elementi facoltativi, che vengono valutati solo se l'applicazione o l'impostazione pertinente esiste nel dispositivo.

Per altre informazioni, vedere Creare linee di base di configurazione in Configuration Manager.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Configurare una baseline di configurazione

Questo esempio usa innanzitutto il cmdlet Get-CMConfigurationItem per ottenere una serie di elementi di configurazione (CIs).

Esegue quindi lo splat dei parametri del cmdlet nella variabile parameters . Non è necessario eseguire lo splat dei parametri, ma semplifica la lettura dei parametri per una riga di comando così lunga.

L'ultimo comando configura la linea di base PSTestBaseLine con un nuovo nome e descrizione, rimuove una categoria e aggiunge le interfacce di configurazione.

$objPSTestWinAppCI = Get-CMConfigurationItem -Name PSTestWinAppCI
$objPSTestWinAppCI2 = Get-CMConfigurationItem -Name PSTestWinAppCI2
$objPSTestWinOSCI = Get-CMConfigurationItem -Name PSTestWinOSCI
$objPSTestWinAppCI3 = Get-CMConfigurationItem -Name PSTestWinAppCI3
$objPSTestWinAppCI4 = Get-CMConfigurationItem -Name PSTestWinAppCI4
$objPSTestMDCI = Get-CMConfigurationItem -Name PSTestMDCI
$objPSTestMacCI = Get-CMConfigurationItem -Name PSTestMacCI

$parameters = @{
  Name = "PSTestBaseLine"
  NewName = "PSTestBaseLineNew"
  Description = "DCM Testing New"
  RemoveCategory = ("IT Infrastructure")
  AddRequiredConfigurationItems = ($objPSTestWinAppCI4.CI_ID,$objPSTestMDCI.CI_ID)
  AddProhibitedConfigurationItems = ($objPSTestWinAppCI.CI_ID)
  AddOSConfigurationItems = ($objPSTestWinOSCI.CI_ID,$objPSTestMacCI.CI_ID)
  AddOptionalConfigurationItems = ($objPSTestWinAppCI2.CI_ID,$objPSTestWinAppCI3.CI_ID)
}

Set-CMBaseline @parameters

Esempio 2: Aggiungere una categoria personalizzata

In questo esempio viene innanzitutto usato il cmdlet New-CMCategory per creare una categoria di base personalizzata Accounting. Configura quindi la baseline di contabilità per aggiungere la nuova categoria.

$category = New-CMCategory -CategoryType BaselineCategories -Name "Accounting"
Set-CMBaseline -Name "Accounting baseline" -AddCategory $category.LocalizedCategoryInstanceName

Parametri

-AddBaseline

Specificare una matrice di ID di base da aggiungere come dati di configurazione alla baseline di destinazione. Questo valore è la proprietà CI_ID della linea di base, ad esempio 16777516.

Tipo:String[]
Alias:AddBaselines
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AddCategory

Specificare una matrice di nomi di categorie di configurazione da aggiungere alle linee di base di configurazione. Queste categorie migliorano la ricerca e il filtro. Per impostazione predefinita, il sito include le categorie seguenti per le baseline di configurazione:

  • Client
  • Infrastruttura IT
  • Line-of-business
  • Server

Per usare un'altra categoria, aggiungerla prima con il cmdlet New-CMCategory e -CategoryType BaselineCategories il parametro .

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AddOptionalConfigurationItem

Specificare una matrice di ID elemento di configurazione da aggiungere con uno scopo facoltativo . Il client di Configuration Manager valuta gli elementi facoltativi solo se nel dispositivo esiste l'applicazione pertinente.

Questo valore è la proprietà CI_ID dell'elemento di configurazione, ad esempio 16777514.

Tipo:String[]
Alias:AddOptionalConfigurationItems
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AddOSConfigurationItem

Specificare una matrice di ID elemento di configurazione da aggiungere di tipo sistema operativo. Questo valore è la proprietà CI_ID dell'elemento di configurazione, ad esempio 16777514.

Tipo:String[]
Alias:AddOSConfigurationItems
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AddProhibitedConfigurationItem

Specificare una matrice di ID elemento di configurazione da aggiungere con uno scopo non consentito . Questo valore è la proprietà CI_ID dell'elemento di configurazione, ad esempio 16777514.

Tipo:String[]
Alias:AddProhibitedConfigurationItems
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AddRequiredConfigurationItem

Specificare una matrice di ID elemento di configurazione da aggiungere con uno scopo obbligatorio . Questo valore è la proprietà CI_ID dell'elemento di configurazione, ad esempio 16777514.

Tipo:String[]
Alias:AddRequiredConfigurationItems
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AddSoftwareUpdate

Specificare una matrice di ID di aggiornamento software da aggiungere.

Tipo:String[]
Alias:AddSoftwareUpdates
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AllowComanagedClients

Impostare questo parametro su $true per applicare sempre questa baseline anche per i client co-gestiti.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ClearBaseline

Aggiungere questo parametro per rimuovere tutte le baseline come condizioni di valutazione dalla baseline di destinazione. Per rimuovere le singole baseline, usare il parametro RemoveBaseline .

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ClearOptionalConfigurationItem

Aggiungere questo parametro per rimuovere tutti gli elementi di configurazione facoltativi come condizioni di valutazione dalla baseline di destinazione. Per rimuovere singole interfacce di interfaccia di comando facoltative, usare il parametro RemoveOptionalConfigurationItem .

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ClearOSConfigurationItem

Aggiungere questo parametro per rimuovere tutti gli elementi di configurazione del sistema operativo come condizioni di valutazione dalla baseline di destinazione. Per rimuovere singoli CIS del sistema operativo, usare il parametro RemoveOSConfigurationItem .

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ClearProhibitedConfigurationItem

Aggiungere questo parametro per rimuovere tutti gli elementi di configurazione non consentiti come condizioni di valutazione dalla baseline di destinazione. Per rimuovere le singole interfacce di interfaccia di rete non consentite, usare il parametro RemoveProhibitedConfigurationItem .

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ClearRequiredConfigurationItem

Aggiungere questo parametro per rimuovere tutti gli elementi di configurazione necessari come condizioni di valutazione dalla baseline di destinazione. Per rimuovere le singole interfacce di interfaccia della riga di comando necessarie, usare il parametro RemoveRequiredConfigurationItem .

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ClearSoftwareUpdate

Aggiungere questo parametro per rimuovere tutti gli aggiornamenti software come condizioni di valutazione dalla baseline di destinazione. Per rimuovere singoli aggiornamenti software, usare il parametro RemoveSoftwareUpdate .

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Description

Specificare una descrizione facoltativa della baseline di configurazione per identificarla.

Tipo:String
Alias:LocalizedDescription
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DesiredConfigurationDigestPath

Specificare un percorso per i dati di configurazione archiviati come digest XML.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

Specificare il CI_ID della baseline di configurazione da configurare. Ad esempio, 16777516.

Tipo:Int32
Alias:CIId, CI_ID
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specificare un oggetto baseline di configurazione da configurare. Per ottenere questo oggetto, usare il cmdlet Get-CMBaseline .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specificare il nome della baseline di configurazione da configurare.

Tipo:String
Alias:LocalizedDisplayName
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NewName

Specificare un nuovo nome per la baseline di configurazione. Usare questo parametro per rinominare la baseline di destinazione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassThru

Aggiungere questo parametro per restituire un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet potrebbe non generare alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RemoveBaseline

Specificare una matrice di ID di base da rimuovere come dati di configurazione dalla baseline di destinazione. Questo valore è la proprietà CI_ID della linea di base, ad esempio 16777516. Per rimuovere tutte le baseline come dati di configurazione da questa linea di base, usare il parametro ClearBaseline .

Tipo:String[]
Alias:RemoveBaselines
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RemoveCategory

Specificare una matrice di nomi di categoria di configurazione da rimuovere dalla baseline di configurazione.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RemoveOptionalConfigurationItem

Specificare una matrice di ID CI facoltativi da rimuovere come dati di configurazione dalla baseline di destinazione. Questo valore è la proprietà CI_ID dell'elemento di configurazione, ad esempio 16777514. Per rimuovere tutti gli elementi di configurazione facoltativi da questa linea di base, usare il parametro ClearOptionalConfigurationItem .

Tipo:String[]
Alias:RemoveOptionalConfigurationItems
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RemoveOSConfigurationItem

Specificare una matrice di ID CI del sistema operativo da rimuovere come dati di configurazione dalla baseline di destinazione. Questo valore è la proprietà CI_ID dell'elemento di configurazione, ad esempio 16777514. Per rimuovere tutti gli elementi di configurazione del sistema operativo da questa linea di base, usare il parametro ClearOSConfigurationItem .

Tipo:String[]
Alias:RemoveOSConfigurationItems
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RemoveProhibitedConfigurationItem

Specificare una matrice di ID CI non consentiti da rimuovere come dati di configurazione dalla baseline di destinazione. Questo valore è la proprietà CI_ID dell'elemento di configurazione, ad esempio 16777514. Per rimuovere tutti gli elementi di configurazione non consentiti da questa baseline, usare il parametro ClearProhibitedConfigurationItem .

Tipo:String[]
Alias:RemoveProhibitedConfigurationItems
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RemoveRequiredConfigurationItem

Specificare una matrice di ID CI necessari da rimuovere come dati di configurazione dalla baseline di destinazione. Questo valore è la proprietà CI_ID dell'elemento di configurazione, ad esempio 16777514. Per rimuovere tutti gli elementi di configurazione necessari da questa baseline, usare il parametro ClearRequiredConfigurationItem .

Tipo:String[]
Alias:RemoveRequiredConfigurationItems
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RemoveSoftwareUpdate

Specificare una matrice di ID di aggiornamento software da rimuovere come dati di configurazione dalla baseline di destinazione. Per rimuovere tutti gli aggiornamenti software da questa baseline, usare il parametro ClearSoftwareUpdate .

Tipo:String[]
Alias:RemoveSoftwareUpdates
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object