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

Gilt für: Konfigurations-Manager (Current Branch)

Diese Versionshinweise fassen Änderungen an der Konfigurations-Manager Cmdlet-Bibliothek in Version 2103 zusammen.

Hinweis

Konfigurations-Manager Current Branch Version 2010 ist die Grundlage für diese Änderungen. Weitere Informationen finden Sie unter Änderungen der Konfigurations-Manager-Cmdlet-Bibliothek für Version 2010.

Bekanntes Problem mit aktualisierbarer PowerShell-Hilfe

Ab Version 2010 können Sie das Update-Help-Cmdlet verwenden, um die neuesten Informationen für das Konfigurations-Manager PowerShell-Modul herunterzuladen.

In Version 2103 wurde die PowerShell-Modulstruktur von 29 DLLs auf zwei geändert. Die PowerShell-XML-Hilfedateien sind der DLL für die Cmdlets zugeordnet. Daher ist der Hilfeinhalt der Version 2010 mit einer Konsole der Version 2103 nicht kompatibel, und der Hilfeinhalt der Version 2103 ist mit einer Konsole der Version 2010 nicht kompatibel.

Aufgrund dieser Änderung der Struktur und Veröffentlichung des aktualisierbaren Inhalts mit der Veröffentlichung von Version 2103 sollten Sie Update-Help nicht auf einer Website der Version 2010 verwenden. Aktualisieren Sie die Website auf Version 2103, und aktualisieren Sie dann die lokalen Hilfeinhalte.

Das Cmdlet lädt erfolgreich Inhalte auf einer Konsole der Version 2010 herunter, aber Get-Help gibt nur Standardnutzungsinformationen zurück. Dieses Verhalten ist darauf zurückzuführen, dass PowerShell die Cmdlet-Informationen nicht in der richtigen XML-Datei finden kann, was jetzt anders ist. Wenn Sie vor der Veröffentlichung von Version 2103 Update-Help mit einer Website der Version 2010 verwendet haben, können Sie Get-Help jetzt weiterhin verwenden.

Wenn Sie Update-Help auf einer Website der Version 2010 verwendet haben, führen Sie Update-Help nach dem Update auf Version 2103 erneut aus, um die kompatible Version des Hilfeinhalts abzurufen. Andernfalls gibt Get-Help nur Standardnutzungsinformationen zurück.

Hinweis

Dieses Problem gilt nur für Version 2010. Aufgrund der geänderten Struktur sollte dies für spätere Versionen kein Problem darstellen.

PowerShell-Modul

Wenn die Konfigurations-Manager-Konsole auf dem Gerät noch keine Verbindung zu einer Site hergestellt hat, wird beim manuellen Importieren des ConfigurationManager-Moduls ein PowerShell-Laufwerk für die Site basierend auf dem standardmäßigen SMS-Anbieter erstellt.

Ab Version 2103 erfordert das PowerShell-Modul ConfigurationManager Microsoft .NET Version 4.7.2 oder höher.

Cmdlets, die PowerShell Version 7 nicht unterstützen

Während Konfigurations-Manager-Cmdlets allgemeine Unterstützung für PowerShell Version 7 bieten, unterstützen die folgenden Cmdlets PowerShell 7 nicht:

  • Import-CMPackage
  • Import-CMDriverPackage
  • Import-CMTaskSequence
  • Export-CMPackage
  • Export-CMDriverPackage
  • Export-CMTaskSequence

Sie erfordern .NET Framework anstelle von .NET Core, das mit PowerShell Version 7 verwendet wird.

Wenn Sie ab Version 2103 versuchen, diese Cmdlets in einer PowerShell Version 7-Sitzung zu verwenden, schlagen sie mit dem folgenden Fehler fehl: This cmdlet only supports the ".NET Framework" runtime.

Neue Cmdlets

Cmdletänderungen

Die folgenden Änderungen wurden an vorhandenen Cmdlets in dieser Version vorgenommen. Änderungen können neue Funktionen, Fehlerbehebungen oder veraltete Produkte sein. Einige Änderungen können fehlerhaft 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.

Schneller Support

Die folgenden Cmdlets unterstützen jetzt den Fast-Parameter . Verwenden Sie diesen Parameter, damit verzögerte Eigenschaften nicht automatisch aktualisiert werden. Lazy Properties enthalten Werte, die relativ ineffizient abzurufen sind. Das Abrufen dieser Eigenschaften kann zu mehr Netzwerkdatenverkehr führen und sich auf die Leistung von Cmdlets auswirken.

  • Get-CMAlert
  • Get-CMAlertSubscription
  • Get-CMBaseline
  • Get-CMBaselineDeployment
  • Get-CMBaselineDeploymentStatus
  • Get-CMClientCertificatePfx
  • Get-CMComplianceRule
  • Get-CMComplianceSetting
  • Get-CMConfigurationPlatform
  • Get-CMConfigurationPolicyDeployment
  • Get-CMDriver
  • Get-CMDriverPackage
  • Get-CMTaskSequence
  • Get-CMTaskSequenceDeployment

Add-CMFallbackStatusPoint

Nicht unterbrechende Änderungen

Ein inkonsistenter Parametername wurde behoben.

Copy-CMCollection

Nicht unterbrechende Änderungen

Die Validierung mit dem NewName-Parameter wurde korrigiert, um ihn an die Konsole anzupassen.

Get-CMDeploymentStatusDetails

Nicht unterbrechende Änderungen

  • Das Problem bei der Überprüfung des Eingabeobjekttyps für Typen wie SMS_DCMDeploymentErrorStatus, SMS_DCMDeploymentNonCompliantStatus und SMS_DCMDeploymentCompliantStatus wurde behoben.
  • Das Problem mit dem ungültigen Klassentyp der Ausgabe wurde behoben , indem der SMS_AppDeploymentRequirementsNotMetStatus des Ausgabeobjekttyps in SMS_AppDeploymentRequirementsNotMetAssetDetails geändert wurde.
  • Der Ausgabeobjekttyp wurde von SMS_AppDeploymentAssetDetails in SMS_AppDeploymentErrorAssetDetails geändert , um weitere Fehlerdetails anzuzeigen.
  • Es wurde ein Eingabeobjekttyp SMS_UpdateDeploymentSummary hinzugefügt, sodass dieses Cmdlet Details zur Updatebereitstellung abrufen kann. Wenn die Ausgabe von Get-CMSoftwareUpdateDeploymentStatus an Get-CMDeploymentStatusDetails übergeben wird, werden Bereitstellungsdetails aus SMS_SUMDeploymentAssetDetails zurückgegeben.

Get-CMDriver

Nicht unterbrechende Änderungen

Möglichkeit zum Filtern nach Parameter "AdministrativeCategory" hinzugefügt.

$category1 = Get-CMCategory -CategoryType DriverCategories -Name 'OEM 1'
$category2 = Get-CMCategory -CategoryType DriverCategories -Name 'OEM 2'
$categories = $category1,$category2

Get-CMDriver -AdministrativeCategory $categories

Get-CMPackage

Nicht unterbrechende Änderungen

Parameter PackageType zum Abrufen eines bestimmten Pakettyps hinzugefügt.

Get-CMSoftwareUpdateDeployment

Nicht unterbrechende Änderungen

Ein Problem bei der Bereitstellung von Updates ohne Paket wurde behoben.

New-CMApplication

Fehler, die behoben wurden

Ein Problem mit der Anzeige des Softwarecenters bei der Installation von Apps, die mit dem Zeitformat "JJJJ/MM/TT" erstellt wurden, wurde behoben.

New-CMCertificateProfileScep

Fehler, die behoben wurden

Ein Problem mit dem Parameter "SanType" wurde behoben.

New-CMCollection

Nicht unterbrechende Änderungen

Die Überprüfung mit dem Namensparameter wurde korrigiert, um sie an die Konsole anzupassen.

New-CMOperatingSystemImage

Nicht unterbrechende Änderungen

Parameter "Index" hinzugefügt. Wenn Sie diesen Parameter hinzufügen, extrahiert die Website ein einzelnes Indexbild aus einem Multiindexbild. Anschließend wird das neue Bild im selben Quellordner wie das ursprüngliche Bild abgelegt.

New-CMOperatingSystemInstaller

Nicht unterbrechende Änderungen

Parameter "Index" hinzugefügt. Wenn Sie diesen Parameter hinzufügen, ersetzt die Website das aktuelle Multiindexbild durch ein neues Bild mit einem einzelnen Index.

New-CMTSRule

Nicht unterbrechende Änderungen

Parameter ReferencedVariableOperator hat einen anderen möglichen Wert: NotLike.

New-CMTSStepConditionVariable

Nicht unterbrechende Änderungen

Parameter OperatorType hat einen anderen möglichen Wert: NotLike

New-CMSoftwareUpdateAutoDeploymentRule

Wichtige Änderungen

Ein Problem für den Parameter O365LanguageSelection wurde behoben. Sie müssen nun eine Sprache mit einem Namen für Land/Region angeben. Durch diese Änderung wird dieser Parameter an die Optionen in der Konfigurations-Manager-Konsole angepasst. Beispiel: -O365LanguageSelection "English (USA)"

Set-CMCertificateProfileScep

Fehler, die behoben wurden

Ein Problem mit dem Parameter "SanType" wurde behoben.

Set-CMClientPushInstallation

Nicht unterbrechende Änderungen

Fügen Sie den Parameter "AllownNTLMFallback" hinzu, um den NTLM-Fallback zu aktivieren.

Set-CMCollection

Nicht unterbrechende Änderungen

Die Validierung mit dem NewName-Parameter wurde korrigiert, um ihn an die Konsole anzupassen.

Set-CMEmailProfile

Nicht unterbrechende Änderungen

  • Problem mit dem Parameter "Neuer Name" behoben, wenn der Kontobenutzername angegeben sAMAccountName wurde.
  • Ein Parameterproblem beim Auflösen von DomainName wurde behoben.

Set-CMFallbackStatusPoint

Nicht unterbrechende Änderungen

Ein inkonsistenter Parametername wurde behoben.

Set-CMThirdPartyUpdateCatalog

Nicht unterbrechende Änderungen

Fügen Sie die Parameter CategoryNamePublishOption und CategoryIdPublishOption hinzu. Verwenden Sie diese Parameter, um beim Abonnieren eines v3-Katalogs die Option zur Kategorieveröffentlichung festzulegen.

$id = "5768207d-6c40-465b-ad65-50501661368f"
$option = [Microsoft.ConfigurationManagement.Cmdlets.Sum.Commands.PublishOptionType]::MetadataOnly
$idOptionPair = @{$id = $option}
Set-CMThirdPartyUpdateCatalog -CatalogName 'pmp' -CategoryIdPublishOption $idOptionPair -Subscribe -Force
$name = "2BrightSparks"
$name1 = "8x8, Inc."
$option = [Microsoft.ConfigurationManagement.Cmdlets.Sum.Commands.PublishOptionType]::MetadataOnly
$nameOptionPair = @{$name = $option; $name1 = $option}
Set-CMThirdPartyUpdateCatalog -CatalogName pmp -CategoryNamePublishOption $nameOptionPair -Subscribe -Force

Set-CMThirdPartyUpdateCategory

Nicht unterbrechende Änderungen

Es wurde ein Problem behoben, bei dem der Parameter "PublishOption" auf festgelegt war FullContent.

Set-CMTSStep*

Beispielsweise Set-CMTSStepApplyDataImage und die 34 anderen ähnlichen Cmdlets.

Nicht unterbrechende Änderungen

Parameter OperatorType hat einen anderen möglichen Wert: NotLike

Set-CMSoftwareUpdateAutoDeploymentRule

Wichtige Änderungen

Ein Problem für den Parameter O365LanguageSelection wurde behoben. Sie müssen nun eine Sprache mit einem Ländernamen angeben. Durch diese Änderung wird dieser Parameter an die Optionen in der Konfigurations-Manager-Konsole angepasst. Beispiel: -O365LanguageSelection "English (USA)"

Feedback abgeben oder Probleme melden

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

Verwenden Sie zum Senden von Feedback die Konfigurations-Manager-Konsole. Weitere Informationen finden Sie unter Feedback für PowerShell.