Set-CMBaseline

Modul:

ConfigurationManager

Ändern sie die Einstellungen von Konfigurationsbaselines.

Syntax

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>]

Beschreibung

Verwenden Sie dieses Cmdlet, um die Einstellungen einer Konfigurationsbaseline in Configuration Manager zu ändern. Eine Konfigurationsbaseline kann die folgenden Arten von Konfigurationsdaten enthalten:

• Konfigurationselemente
• Andere Konfigurationsbaselines
• Softwareupdates

Der Configuration Manager-Client bewertet seine Konformität anhand dieser Baseline. Wenn alle angegebenen Elemente kompatibel sind, wird die Baseline selbst als konform bewertet. Sie können auch optionale Elemente einschließen, die nur ausgewertet werden, wenn die relevante Anwendung oder Einstellung auf dem Gerät vorhanden ist.

Weitere Informationen finden Sie unter Erstellen von Konfigurationsbaselines in Configuration Manager.

Hinweis

Führen Sie Configuration Manager Cmdlets auf dem Configuration Manager-Websitelaufwerk aus, z. PS XYZ:\>B. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Konfigurieren einer Konfigurationsbaseline

In diesem Beispiel wird zunächst das Cmdlet Get-CMConfigurationItem verwendet, um eine Reihe von Konfigurationselementen (CIs) abzurufen.

Anschließend werden die Cmdlet-Parameter in die Parametervariablesplatiert. Es ist nicht erforderlich, die Parameter zu splatieren, es erleichtert nur das Lesen der Parameter für eine so lange Befehlszeile.

Der letzte Befehl konfiguriert die PSTestBaseLine-Baseline mit einem neuen Namen und einer neuen Beschreibung, entfernt eine Kategorie und fügt die CIs hinzu.

$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

Beispiel 2: Hinzufügen einer benutzerdefinierten Kategorie

In diesem Beispiel wird zunächst das Cmdlet New-CMCategory verwendet, um eine benutzerdefinierte Baselinekategorie Buchhaltung zu erstellen. Anschließend wird die Buchhaltungsbaseline so konfiguriert, dass die neue Kategorie hinzugefügt wird.

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

Parameter

-AddBaseline

Geben Sie ein Array von Baseline-IDs an, die der Zielbaseline als Konfigurationsdaten hinzugefügt werden sollen. Dieser Wert ist die CI_ID Eigenschaft der Baseline, 16777516z. B. .

Type:	String[]
Aliases:	AddBaselines
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AddCategory

Geben Sie ein Array von Konfigurationskategorienamen an, die den Konfigurationsbaselines hinzugefügt werden sollen. Diese Kategorien verbessern die Suche und Filterung. Standardmäßig enthält der Standort die folgenden Kategorien für Konfigurationsbaselines:

• Client
• IT-Infrastruktur
• Branche
• Server

Um eine andere Kategorie zu verwenden, fügen Sie diese zuerst mit dem Cmdlet New-CMCategory und -CategoryType BaselineCategories dem Parameter hinzu.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AddOptionalConfigurationItem

Geben Sie ein Array von Konfigurationselement-IDs an, die mit einem optionalen Zweck hinzugefügt werden sollen. Der Configuration Manager Client wertet optionale Elemente nur aus, wenn die relevante Anwendung auf dem Gerät vorhanden ist.

Dieser Wert ist die CI_ID Eigenschaft des Konfigurationselements, 16777514z. B. .

Type:	String[]
Aliases:	AddOptionalConfigurationItems
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AddOSConfigurationItem

Geben Sie ein Array von Konfigurationselement-IDs an, die vom Typ Betriebssystem hinzugefügt werden sollen. Dieser Wert ist die CI_ID Eigenschaft des Konfigurationselements, 16777514z. B. .

Type:	String[]
Aliases:	AddOSConfigurationItems
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AddProhibitedConfigurationItem

Geben Sie ein Array von Konfigurationselement-IDs an, die mit einem unzulässigen Zweck hinzugefügt werden sollen. Dieser Wert ist die CI_ID Eigenschaft des Konfigurationselements, 16777514z. B. .

Type:	String[]
Aliases:	AddProhibitedConfigurationItems
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AddRequiredConfigurationItem

Geben Sie ein Array von Konfigurationselement-IDs an, die mit einem erforderlichen Zweck hinzugefügt werden sollen. Dieser Wert ist die CI_ID Eigenschaft des Konfigurationselements, 16777514z. B. .

Type:	String[]
Aliases:	AddRequiredConfigurationItems
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AddSoftwareUpdate

Geben Sie ein Array von Softwareupdate-IDs an, die hinzugefügt werden sollen.

Type:	String[]
Aliases:	AddSoftwareUpdates
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowComanagedClients

Legen Sie diesen Parameter auf fest $true , um diese Baseline auch für gemeinsam verwaltete Clients immer anzuwenden.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClearBaseline

Fügen Sie diesen Parameter hinzu, um alle Baselines als Auswertungsbedingungen aus der Zielbaseline zu entfernen. Um einzelne Baselines zu entfernen, verwenden Sie den RemoveBaseline-Parameter .

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClearOptionalConfigurationItem

Fügen Sie diesen Parameter hinzu, um alle optionalen Konfigurationselemente als Auswertungsbedingungen aus der Zielbaseline zu entfernen. Verwenden Sie zum Entfernen einzelner optionaler Zertifizierungsstellen den Parameter RemoveOptionalConfigurationItem .

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClearOSConfigurationItem

Fügen Sie diesen Parameter hinzu, um alle Betriebssystemkonfigurationselemente als Auswertungsbedingungen aus der Zielbaseline zu entfernen. Um einzelne Betriebssystem-CIs zu entfernen, verwenden Sie den Parameter RemoveOSConfigurationItem .

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClearProhibitedConfigurationItem

Fügen Sie diesen Parameter hinzu, um alle unzulässigen Konfigurationselemente als Auswertungsbedingungen aus der Zielbaseline zu entfernen. Verwenden Sie den RemoveProhibitedConfigurationItem-Parameter, um einzelne unzulässige Zertifizierungsstellen zu entfernen.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClearRequiredConfigurationItem

Fügen Sie diesen Parameter hinzu, um alle erforderlichen Konfigurationselemente als Auswertungsbedingungen aus der Zielbaseline zu entfernen. Um einzelne erforderliche Zertifizierungsstellen zu entfernen, verwenden Sie den RemoveRequiredConfigurationItem-Parameter .

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClearSoftwareUpdate

Fügen Sie diesen Parameter hinzu, um alle Softwareupdates als Auswertungsbedingungen aus der Zielbaseline zu entfernen. Verwenden Sie den Parameter RemoveSoftwareUpdate , um einzelne Softwareupdates zu entfernen.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Geben Sie eine optionale Beschreibung der Konfigurationsbaseline an, um sie zu identifizieren.

Type:	String
Aliases:	LocalizedDescription
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DesiredConfigurationDigestPath

Geben Sie einen Pfad zu den Konfigurationsdaten an, die als XML-Digest gespeichert sind.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

Geben Sie die CI_ID der zu konfigurierenden Konfigurationsbaseline an. Beispiel: 16777516.

Type:	Int32
Aliases:	CIId, CI_ID
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Geben Sie ein zu konfigurierende Konfigurationsbaselineobjekt an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMBaseline .

Type:	IResultObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Geben Sie den Namen der zu konfigurierenden Konfigurationsbaseline an.

Type:	String
Aliases:	LocalizedDisplayName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NewName

Geben Sie einen neuen Namen für die Konfigurationsbaseline an. Verwenden Sie diesen Parameter, um die Zielbaseline umzubenennen.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

Fügen Sie diesen Parameter hinzu, um ein Objekt zurückzugeben, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveBaseline

Geben Sie ein Array von Baseline-IDs an, die als Konfigurationsdaten aus der Zielbaseline entfernt werden sollen. Dieser Wert ist die CI_ID Eigenschaft der Baseline, 16777516z. B. . Um alle Baselines als Konfigurationsdaten aus dieser Baseline zu entfernen, verwenden Sie den ClearBaseline-Parameter .

Type:	String[]
Aliases:	RemoveBaselines
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveCategory

Geben Sie ein Array von Konfigurationskategorienamen an, die aus der Konfigurationsbaseline entfernt werden sollen.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveOptionalConfigurationItem

Geben Sie ein Array optionaler CI-IDs an, die als Konfigurationsdaten aus der Zielbaseline entfernt werden sollen. Dieser Wert ist die CI_ID Eigenschaft des Konfigurationselements, 16777514z. B. . Um alle optionalen Konfigurationselemente aus dieser Baseline zu entfernen, verwenden Sie den ClearOptionalConfigurationItem-Parameter .

Type:	String[]
Aliases:	RemoveOptionalConfigurationItems
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveOSConfigurationItem

Geben Sie ein Array von Betriebssystem-CI-IDs an, die als Konfigurationsdaten aus der Zielbaseline entfernt werden sollen. Dieser Wert ist die CI_ID Eigenschaft des Konfigurationselements, 16777514z. B. . Um alle Betriebssystemkonfigurationselemente aus dieser Baseline zu entfernen, verwenden Sie den ClearOSConfigurationItem-Parameter .

Type:	String[]
Aliases:	RemoveOSConfigurationItems
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveProhibitedConfigurationItem

Geben Sie ein Array unzulässiger CI-IDs an, die als Konfigurationsdaten aus der Zielbaseline entfernt werden sollen. Dieser Wert ist die CI_ID Eigenschaft des Konfigurationselements, 16777514z. B. . Um alle unzulässigen Konfigurationselemente aus dieser Baseline zu entfernen, verwenden Sie den ClearProhibitedConfigurationItem-Parameter .

Type:	String[]
Aliases:	RemoveProhibitedConfigurationItems
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveRequiredConfigurationItem

Geben Sie ein Array der erforderlichen CI-IDs an, die als Konfigurationsdaten aus der Zielbaseline entfernt werden sollen. Dieser Wert ist die CI_ID Eigenschaft des Konfigurationselements, 16777514z. B. . Um alle erforderlichen Konfigurationselemente aus dieser Baseline zu entfernen, verwenden Sie den ClearRequiredConfigurationItem-Parameter .

Type:	String[]
Aliases:	RemoveRequiredConfigurationItems
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveSoftwareUpdate

Geben Sie ein Array von Softwareupdate-IDs an, die als Konfigurationsdaten aus der Zielbaseline entfernt werden sollen. Um alle Softwareupdates aus dieser Baseline zu entfernen, verwenden Sie den Parameter ClearSoftwareUpdate .

Type:	String[]
Aliases:	RemoveSoftwareUpdates
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object

Ähnliche Themen

• Disable-CMBaseline
• Enable-CMBaseline
• Export-CMBaseline
• Get-CMBaseline
• Import-CMBaseline
• New-CMBaseline
• Remove-CMBaseline
• Get-CMBaselineXMLDefinition
• Get-CMBaselineSummarizationSchedule
• Erstellen von Konfigurationsbaselines in Configuration Manager