Änderungen an Konfigurations-Manager Cmdlet-Bibliothek für Version 2107

Gilt für: Configuration Manager (Current Branch)

In diesen Versionshinweisen werden Die Änderungen an der Cmdlet-Bibliothek Konfigurations-Manager in Version 2107 zusammengefasst.

Hinweis

Konfigurations-Manager Current Branch-Version 2103 ist die Baseline für diese Änderungen. Weitere Informationen finden Sie unter Konfigurations-Manager Cmdlet-Bibliotheksänderungen für Version 2103.

Neue Cmdlets für App-Bereitstellungstypen

Verwalten des Installationsverhaltens für Anwendungsbereitstellungstypen

Dieser Satz neuer Cmdlets ist für das Installationsverhalten des Anwendungsbereitstellungstyps vorgesehen. Weitere allgemeine Informationen über das Feature „Installationsverhalten“ finden Sie unter Überprüfen auf ausführbare Dateien, die ausgeführt werden.

Add-CMDeploymentTypeInstallBehavior

Fügen Sie mit diesem Cmdlet dem angegebenen Bereitstellungstyp die ausführbaren Dateien hinzu, die für eine erfolgreiche Installation der App geschlossen werden müssen.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Add-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe" -DisplayName "Notepad"

Weitere Informationen finden Sie unter Add-CMDeploymentTypeInstallBehavior.

Get-CMDeploymentTypeInstallBehavior

Rufen Sie mit diesem Cmdlet vom angegebenen Bereitstellungstyp die Liste der ausführbaren Dateien ab, die für eine erfolgreiche Installation der App geschlossen werden müssen.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Get-CMDeploymentTypeInstallBehavior -InputObject $msi_dt

Weitere Informationen finden Sie unter Get-CMDeploymentTypeInstallBehavior.

Remove-CMDeploymentTypeInstallBehavior

Entfernen Sie mit diesem Cmdlet aus dem angegebenen Bereitstellungstyp die ausführbaren Dateien, die für eine erfolgreiche Installation der App geschlossen werden müssen.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Remove-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe"

Weitere Informationen finden Sie unter Remove-CMDeploymentTypeInstallBehavior.

Set-CMDeploymentTypeInstallBehavior

Ändern Sie mit diesem Cmdlet die ausführbaren Dateien, die geschlossen werden müssen, damit die Installation der App erfolgreich ist.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Set-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe" -NewExeFileName "calc.exe" -DisplayName "Calculator"

Weitere Informationen finden Sie unter Set-CMDeploymentTypeInstallBehavior.

Verwalten von Rückgabecodes für Anwendungsbereitstellungstypen

Dieser Satz neuer Cmdlets ist für Rückgabecodes des Anwendungsbereitstellungstyps vorgesehen. Weitere allgemeine Informationen finden Sie unter Rückgabecodes des Bereitstellungstyps.

Add-CMDeploymentTypeReturnCode

Mit diesem Cmdlet können Sie einem unterstützten Bereitstellungstyp Rückgabecodes hinzufügen.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Add-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 1602 -Name "User cancel" -CodeType Failure -Description "The user cancelled the installation"

Weitere Informationen finden Sie unter Add-CMDeploymentTypeReturnCode.

Get-CMDeploymentTypeReturnCode

Rufen Sie mit diesem Cmdlet die Liste der Rückgabecodes für den angegebenen Bereitstellungstyp ab.

Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)" | Get-CMDeploymentTypeReturnCode

Weitere Informationen finden Sie unter Get-CMDeploymentTypeReturnCode.

Remove-CMDeploymentTypeReturnCode

Löschen Sie mit diesem Cmdlet Rückgabecodes aus dem angegebenen Bereitstellungstyp.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Remove-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 1602

Weitere Informationen finden Sie unter Remove-CMDeploymentTypeReturnCode.

Set-CMDeploymentTypeReturnCode

Ändern Sie mit diesem Cmdlet Rückgabecodes für den angegebenen Bereitstellungstyp.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Add-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 3010 -Name "Always reboot" -CodeType HardReboot -Description "Change soft reboot to hard reboot"

Weitere Informationen finden Sie unter Set-CMDeploymentTypeReturnCode.

Weitere neue Cmdlets

Get-CMClientSettingDeployment

Stellen Sie mit diesem Cmdlet eine Bereitstellung eines benutzerdefinierten Clienteinstellungsobjekts bereit. Sie können dieses Objekt mit Remove-CMClientSettingDeploymentverwenden.

Weitere Informationen zu Clienteinstellungen finden Sie unter Konfigurieren von Clienteinstellungen.

$clientSetting =  Get-CMClientSetting -Name "Software Center customizations"
$clientSetting | Get-CMClientSettingDeployment

Weitere Informationen finden Sie unter Get-CMClientSettingDeployment.

Get-CMDeploymentTypeDetectionClause

Verwenden Sie dieses Cmdlet, um die Erkennungsklauseln vom angegebenen Bereitstellungstyp abzurufen.

Mit diesem Cmdlet können Sie z. B. eine Erkennungsklausel aus einer App abrufen und auf eine andere App anwenden:

$appMsi = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"

$clause1 = Get-CMDeploymentTypeDetectionClause -InputObject $appMsi

Set-CMScriptDeploymentType -ApplicationName "Configuration Manager console" -DeploymentTypeName "Install" -AddDetectionClause $clause1

Weitere Informationen finden Sie unter Get-CMDeploymentTypeDetectionClause.

Get-CMPersistentUserSettingsGroup

Rufen Sie mit diesem Cmdlet die Liste der standortweiten Einstellungen ab, die Sie gespeichert haben. Diese Einstellungen folgen Ihnen auf verschiedenen Geräten.

Beispiel: Zeigen Sie Configuration Manager-Konsolenbenachrichtigungen an, die aktiv sind, oder die Sie verworfen haben.

Weitere Informationen finden Sie unter Get-CMPersistentUserSettingsGroup.

Get-CMSoftwareUpdateContentInfo

Verwenden Sie dieses Cmdlet, um Informationen zu Softwareupdateinhalten abzurufen.

$update = Get-CMSoftwareUpdate -ArticleId "5004237" -Fast
Get-CMSoftwareUpdateContentInfo -InputObject $update[1]

Weitere Informationen finden Sie unter Get-CMSoftwareUpdateContentInfo.

Remove-CMPersistentUserSettingsGroup

Setzen Sie mit diesem Cmdlet Ihre standortweiten Einstellungen zurück.

Beispiel: Sie können Configuration Manager-Konsolenbenachrichtigungen wiederherstellen, die Sie verworfen haben. Nachdem Sie dieses Cmdlet ausgeführt und die Configuration Manager-Konsole neu gestartet haben, werden alle verfügbaren Benachrichtigungen erneut angezeigt.

Weitere Informationen finden Sie unter Remove-CMPersistentUserSettingsGroup.

Veraltete und entfernte Cmdlets

Die folgenden Cmdlets zum Starten einer Bereitstellung sind veraltet und werden möglicherweise in einer künftigen Version entfernt:

Veraltetes Cmdlet Ersetzung
Start-CMApplicationDeploymentSimulation New-CMApplicationDeployment mit dem Parameter Simulation
Start-CMClientSettingDeployment New-CMClientSettingDeployment
Start-CMAntimalwarePolicyDeployment New-CMAntimalwarePolicyDeployment

Die folgenden Cmdlets sind nicht mehr verfügbar, da die zugrunde liegenden Features nicht mehr unterstützt werden:

  • Add-CMApplicationCatalogWebServicePoint

  • Add-CMApplicationCatalogWebsitePoint

  • Get-CMApplicationCatalogWebServicePoint

  • Get-CMApplicationCatalogWebsitePoint

  • Remove-CMApplicationCatalogWebServicePoint

  • Remove-CMApplicationCatalogWebsitePoint

  • Set-CMApplicationCatalogWebsitePoint

  • Get-CMVhd

  • New-CMVhd

  • Remove-CMVhd

  • Set-CMVhd

Änderungen an Cmdlets

Die folgenden Änderungen wurden an vorhandenen Cmdlets in dieser Version vorgenommen. Änderungen können neue Funktionen oder Fehlerbehebungen sein. Einige Änderungen können breaking sein. Wenn Sie eines der in diesem Abschnitt aufgeführten Cmdlets oder Featurebereiche verwenden, überprüfen Sie die Änderungen sorgfältig, um zu verstehen, wie sie sich auf Ihre Verwendung auswirken können.

Add-CMDeviceCollectionDirectMembershipRule

Weitere Informationen finden Sie unter Add-CMDeviceCollectionDirectMembershipRule.

Behobene Fehler

Es wurde das Problem des Versuchs behoben, Tausende von Geräten als Regeln für die direkte Mitgliedschaft hinzuzufügen.

Add-CMDistributionPoint

Weitere Informationen finden Sie unter Add-CMDistributionPoint.

Wichtige Änderungen

Der standardmäßige freie Mindestspeicherplatz wurde von 50 MB in 500 MB geändert.

Add-CMTaskSequenceStep

Weitere Informationen finden Sie unter Add-CMTaskSequenceStep.

Geringfügige Änderungen

Der unnötige Parameter StepName wurde entfernt.

Disconnect-CMTrackedObject

Weitere Informationen finden Sie unter Disconnect-CMTrackedObject.

Geringfügige Änderungen

Alias Disconnect-CMObject für dieses Cmdlet hinzugefügt.

Get-CMApplicationGroup

Weitere Informationen finden Sie unter Get-CMApplicationGroup.

Behobene Fehler

Es wurde ein Problem behoben, durch das der richtige App-Gruppenpfad erhalten wurde.

Get-CMDeploymentStatusDetails

Weitere Informationen finden Sie unter Get-CMDeploymentStatusDetails.

Behobene Fehler

Die Abfragebedingung wurde behoben, um ein potenzielles Typkonfliktproblem zu vermeiden.

Import-CMAntimalwarePolicy

Weitere Informationen finden Sie unter Import-CMAntimalwarePolicy.

Geringfügige Änderungen

Unterstützung für Die Richtlinie für den Überwachungsmodus wurde mit potenziell unerwünschten Anwendungen hinzugefügt. Weitere Informationen finden Sie unter Überwachungsmodus für potenziell unerwünschte Anwendungen.

Import-CMQuery

Weitere Informationen finden Sie unter Import-CMQuery.

Behobene Fehler

Es wurde ein Problem behoben, durch das die Blockierung der Importfunktion aufgehoben wurde.

New-CMAdministrativeUser

Weitere Informationen finden Sie unter New-CMAdministrativeUser.

Behobene Fehler

Ein Problem wurde behoben, bei dem der Benutzername me lautete.

New-CMApplicationDeployment

Weitere Informationen finden Sie unter New-CMApplicationDeployment.

Geringfügige Änderungen

Der AutoCloseExecutable-Parameter wurde hinzugefügt, um die Anwendungsbereitstellungseinstellung für Installationsverhalten zu aktivieren.

New-CMCloudManagementGateway

Weitere Informationen finden Sie unter New-CMCloudManagementGateway.

Wichtige Änderungen

Der Parameter ServiceCertPassword ist jetzt erforderlich.

New-CMMigrationJob

Weitere Informationen finden Sie unter New-CMMigrationJob.

Behobene Fehler

Die Blockierung der Migration von Softwareverteilungsbereitstellungsobjekten wurde aufgehoben.

New-CMSecondarySite

Weitere Informationen finden Sie unter New-CMSecondarySite.

Wichtige Änderungen

Der standardmäßige freie Speicherplatz wurde von 200 MB in 500 MB geändert.

New-CMSoftwareUpdateAutoDeploymentRule

Weitere Informationen finden Sie unter New-CMSoftwareUpdateAutoDeploymentRule.

Behobene Fehler

Ein Problem mit dem Product-Parameter wurde behoben. Wenn mehrere Produkte mit dem gleichen Namen vorhanden sind, werden alle produkte ausgewählt.

New-CMSoftwareUpdateDeployment

Weitere Informationen finden Sie unter New-CMSoftwareUpdateDeployment.

Geringfügige Änderungen

Dem Parameter Kommentieren wurde ein Alias Beschreibung hinzugefügt.

New-CMTaskSequence

Weitere Informationen finden Sie unter New-CMTaskSequence.

Geringfügige Änderungen

  • Die maximale Länge des Parameters Description wurde auf 512 Zeichen erhöht.

  • Der neue Parameter HighPerformance wurde hinzugefügt, um die Leistungseinstellung zu unterstützen.

  • Der Legacyparameter InstallationLicensingMode wurde entfernt.

  • Der NewInstallOSImageVhd-Parametersatz wurde entfernt.

  • Der InstallOperatingSystemImageVhd-Parameter wurde entfernt.

New-CMTaskSequenceDeployment

Weitere Informationen finden Sie unter New-CMTaskSequenceDeployment.

Behobene Fehler

Ein Problem mit Hochleistungs-Energiesparplänen wurde behoben.

New-CMTSStepApplyDriverPackage

Weitere Informationen finden Sie unter New-CMTSStepApplyDriverPackage.

Geringfügige Änderungen

Eine Bedingung zum Überprüfen eines Pakets für die angegebene PackageId wurde hinzugefügt.

New-CMTSStepApplyOperatingSystem

Weitere Informationen finden Sie unter New-CMTSStepApplyOperatingSystem.

Behobene Fehler

Probleme bei der Validierung des Parameters DestinationVariable wurden behoben, um Werte zuzulassen, die mit einem Unterstrich (_) beginnen.

Geringfügige Änderungen

Der LayeredDriver-Parameter wurde hinzugefügt, um den mehrstufigen Tastaturtreiber während der Betriebssystembereitstellung zu unterstützen.

New-CMTSStepUpgradeOperatingSystem

Weitere Informationen finden Sie unter New-CMTSStepUpgradeOperatingSystem.

Geringfügige Änderungen

Der neue Parameter SoftwareUpdate wurde hinzugefügt, um ein Featureupdate für den Tasksequenzschritt Betriebssystem aktualisieren anzugeben.

Publish-CMPrestageContent

Weitere Informationen finden Sie unter Publish-CMPrestageContent.

Behobene Fehler

Potenzielles Problem mit ungültigen Objekten wurde behoben.

Remove-CMApplicationGroup

Weitere Informationen finden Sie unter Remove-CMApplicationGroup.

Behobene Fehler

Es wurde ein Problem behoben, durch das der richtige App-Gruppenpfad bei Verwendung der Pipeline erhalten wurde.

Set-CMAntimalwarePolicy

Weitere Informationen finden Sie unter Set-CMAntimalwarePolicy.

Geringfügige Änderungen

Der Parameter PuaProtection wurde hinzugefügt, um potenziell unerwünschte Anwendungen zu unterstützen.

Set-CMApplicationDeployment

Weitere Informationen finden Sie unter Set-CMApplicationDeployment.

Geringfügige Änderungen

Der AutoCloseExecutable-Parameter wurde hinzugefügt, um die Anwendungsbereitstellungseinstellung für Installationsverhalten zu aktivieren.

Set-CMClientSetting

Weitere Informationen finden Sie unter Set-CMClientSetting.

Geringfügige Änderungen

Eine aussagekräftige Verwerfungsmeldung für den Parameter SoftwareMetering wurde hinzugefügt.

Set-CMClientSettingSoftwareUpdate

Weitere Informationen finden Sie unter Set-CMClientSettingSoftwareUpdate.

Geringfügige Änderungen

Der Parameter EnableWsusCertPinning wurde hinzugefügt, um das Anheften von Zertifikaten zu unterstützen.

Set-CMDeploymentType

Weitere Informationen finden Sie unter Set-CMDeploymentType.

Behobene Fehler

Problem mit dem Parameter AddRequirement beim Hinzufügen neuer Regeln behoben

Set-CMMsiDeploymentType

Weitere Informationen finden Sie unter Set-CMMsiDeploymentType.

Behobene Fehler

Aktualisieren Sie den Bereitstellungstyp entsprechend dem Installationstyp, um das Zurücksetzen der Konfigurationen zu vermeiden, wenn Sie den Inhaltsort ändern.

Geringfügige Änderungen

Unterstützung für die Angabe eines Ordnerpfads zum Parameter ContentLocation hinzugefügt.

Set-CMTaskSequence

Weitere Informationen finden Sie unter Set-CMTaskSequence.

Geringfügige Änderungen

Der neue Parameter HighPerformance wurde hinzugefügt, um die Leistungseinstellung für die Tasksequenz zu unterstützen.

Set-CMTSStepApplyDriverPackage

Weitere Informationen finden Sie unter Set-CMTSStepApplyDriverPackage.

Geringfügige Änderungen

Eine Bedingung zum Überprüfen eines Pakets für die angegebene PackageId wurde hinzugefügt.

Set-CMTSStepApplyOperatingSystem

Weitere Informationen finden Sie unter Set-CMTSStepApplyOperatingSystem.

Behobene Fehler

Ein Problem mit dem Destination-Parameter wurde behoben.

Geringfügige Änderungen

Der Parameter LayeredDriver wurde hinzugefügt, um mehrschichtige Tastaturtreiber während der Betriebssystembereitstellung zu unterstützen.

Set-CMTSStepUpgradeOperatingSystem

Weitere Informationen finden Sie unter Set-CMTSStepUpgradeOperatingSystem.

Geringfügige Änderungen

Der neue Parameter SoftwareUpdate wurde hinzugefügt, um ein Featureupdate für den Tasksequenzschritt Betriebssystem aktualisieren anzugeben.

Start-CMDistributionPointUpgrade

Weitere Informationen finden Sie unter Start-CMDistributionPointUpgrade.

Wichtige Änderungen

Legen Sie den standardmäßigen freien Mindestspeicherplatz auf 500 MB fest.

Update-CMDistributionPoint

Weitere Informationen finden Sie unter Update-CMDistributionPoint.

Behobene Fehler

Problem behoben, aufgrund dessen Inhalte in Installations- und Deinstallationsordnern aktualisiert werden, wenn sie sich unterscheiden.

Bereitstellen von Feedback oder Melden von Problemen

Viele der in diesem Artikel beschriebenen Korrekturen und Verbesserungen sind das Ergebnis Ihres Feedbacks.

Um Feedback zu senden, verwenden Sie die Konfigurations-Manager Konsole. Weitere Informationen finden Sie unter Feedback zu PowerShell.

Informationen zum Übermitteln neuer Featureanforderungen finden Sie in der PowerShell-Konfigurations-Manager unter UserVoice.