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