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 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 Configuration Manager cmdlet dall'unità del sito 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
.
Type: | String[] |
Aliases: | AddBaselines |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 linee di base 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 .
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddOptionalConfigurationItem
Specificare una matrice di ID elemento di configurazione da aggiungere con uno scopo facoltativo . Il client Configuration Manager valuta solo gli elementi facoltativi se nel dispositivo esiste l'applicazione pertinente.
Questo valore è la proprietà CI_ID dell'elemento di configurazione, ad esempio 16777514
.
Type: | String[] |
Aliases: | AddOptionalConfigurationItems |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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
.
Type: | String[] |
Aliases: | AddOSConfigurationItems |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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
.
Type: | String[] |
Aliases: | AddProhibitedConfigurationItems |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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
.
Type: | String[] |
Aliases: | AddRequiredConfigurationItems |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddSoftwareUpdate
Specificare una matrice di ID di aggiornamento software da aggiungere.
Type: | String[] |
Aliases: | AddSoftwareUpdates |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowComanagedClients
Impostare questo parametro su $true
per applicare sempre questa baseline anche per i client co-gestiti.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Richiede la conferma prima di eseguire il cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Specificare una descrizione facoltativa della baseline di configurazione per identificarla.
Type: | String |
Aliases: | LocalizedDescription |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DesiredConfigurationDigestPath
Specificare un percorso per i dati di configurazione archiviati come digest XML.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Specificare il CI_ID della baseline di configurazione da configurare. Ad esempio, 16777516
.
Type: | Int32 |
Aliases: | CIId, CI_ID |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Specificare un oggetto baseline di configurazione da configurare. Per ottenere questo oggetto, usare il cmdlet Get-CMBaseline .
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Specificare il nome della baseline di configurazione da configurare.
Type: | String |
Aliases: | LocalizedDisplayName |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewName
Specificare un nuovo nome per la baseline di configurazione. Usare questo parametro per rinominare la baseline di destinazione.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | String[] |
Aliases: | RemoveBaselines |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveCategory
Specificare una matrice di nomi di categoria di configurazione da rimuovere dalla baseline di configurazione.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | String[] |
Aliases: | RemoveOptionalConfigurationItems |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | String[] |
Aliases: | RemoveOSConfigurationItems |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | String[] |
Aliases: | RemoveProhibitedConfigurationItems |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | String[] |
Aliases: | RemoveRequiredConfigurationItems |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | String[] |
Aliases: | RemoveSoftwareUpdates |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Output
System.Object
Collegamenti correlati
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per