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 wertet seine Konformität anhand dieser Baseline aus. 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 entsprechende 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-Standortlaufwerk aus, z. B PS XYZ:\>. . 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. .

Typ:	String[]
Aliase:	AddBaselines
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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.

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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. .

Typ:	String[]
Aliase:	AddOptionalConfigurationItems
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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. .

Typ:	String[]
Aliase:	AddOSConfigurationItems
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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. .

Typ:	String[]
Aliase:	AddProhibitedConfigurationItems
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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. .

Typ:	String[]
Aliase:	AddRequiredConfigurationItems
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-AddSoftwareUpdate

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

Typ:	String[]
Aliase:	AddSoftwareUpdates
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-AllowComanagedClients

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

Typ:	Boolean
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ClearBaseline

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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 .

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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 .

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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 .

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Confirm

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

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Description

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

Typ:	String
Aliase:	LocalizedDescription
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DesiredConfigurationDigestPath

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DisableWildcardHandling

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ForceWildcardHandling

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Id

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

Typ:	Int32
Aliase:	CIId, CI_ID
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-InputObject

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

Typ:	IResultObject
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Name

Geben Sie den Namen der zu konfigurierenden Konfigurationsbaseline an.

Typ:	String
Aliase:	LocalizedDisplayName
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-NewName

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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 .

Typ:	String[]
Aliase:	RemoveBaselines
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-RemoveCategory

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

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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 .

Typ:	String[]
Aliase:	RemoveOptionalConfigurationItems
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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 .

Typ:	String[]
Aliase:	RemoveOSConfigurationItems
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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 .

Typ:	String[]
Aliase:	RemoveProhibitedConfigurationItems
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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 .

Typ:	String[]
Aliase:	RemoveRequiredConfigurationItems
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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 .

Typ:	String[]
Aliase:	RemoveSoftwareUpdates
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WhatIf

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

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	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