Konfigurations-Manager der Cmdlet-Bibliothek für Version 2103

  • Artikel

Gilt für: Configuration Manager (Current Branch)

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

Hinweis

Konfigurations-Manager Current Branch Version 2010 ist die Baseline für diese Änderungen. Weitere Informationen finden Sie unter Konfigurations-Manager cmdlet library changes for version 2010 (Änderungen an der Cmdlet-Bibliothek für Version 2010).

Bekanntes Problem mit der aktualisierbaren PowerShell-Hilfe

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

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

Aufgrund dieser Änderung in der Struktur und Veröffentlichung des updatebaren Inhalts mit version 2103 sollten Sie update-help nicht an einem Standort der Version 2010 verwenden. Aktualisieren Sie den Standort auf Version 2103, und aktualisieren Sie dann die lokalen Hilfeinhalte.

Mit dem Cmdlet werden die Inhalte erfolgreich in eine Konsole der Version 2010 heruntergeladen, von Get-Help werden jedoch nur Standardverwendungsinformationen zurückgegeben. Dieses Verhalten liegt daran, dass PowerShell die Cmdlet-Informationen nicht in der richtigen XML-Datei finden kann, was sich jetzt unterscheiden kann. Wenn Sie vor der Veröffentlichung von Version 2103 Update-Help mit einem Standort der Version 2010 verwendet haben, können Sie jetzt weiterhin Get-Help verwenden.

Wenn Sie update-help an einem Standort der Version 2010 verwendet haben, führen Sie nach dem Update auf Version 2103 update-help erneut aus, um die kompatible Version des Hilfeinhalts zu erhalten. Andernfalls gibt Get-Help nur Standardnutzungsinformationen zurück.

Hinweis

Dieses Problem gilt nur für Version 2010. Da sich die Struktur geändert hat, sollte dies kein Problem für spätere Versionen sein.

PowerShell-Modul

Wenn die Configuration Manager-Konsole auf dem Gerät noch keine Verbindung mit einem Standort hergestellt hat, wird beim manuellen Importieren des Configuration Manager-Moduls basierend auf dem SMS-Standardanbieter ein PowerShell-Laufwerk für den Standort erstellt.

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

Cmdlets ohne Unterstützung von PowerShell-Version 7

Während Configuration Manager-Cmdlets allgemeine Unterstützung von PowerShell-Version 7 umfassen, wird PowerShell 7 von den folgenden Cmdlets nicht unterstützt:

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

Diese Cmdlets erfordern .NET Framework anstelle von .NET Core, was von PowerShell-Version 7 verwendet wird.

Wenn Sie ab Version 2103 versuchen, diese Cmdlets in einer PowerShell-Sitzung der Version 7 zu verwenden, tritt der folgende Fehler auf: This cmdlet only supports the ".NET Framework" runtime.

Neue Cmdlets

Änderungen an Cmdlets

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

Fast-Unterstützung

Die folgenden Cmdlets unterstützen jetzt den Fast-Parameter. Verwenden Sie diesen Parameter, damit Lazy-Eigenschaften nicht automatisch aktualisiert werden. Lazy-Eigenschaften enthalten Werte, deren Abruf relativ ineffizient ist. Wenn Sie diese Eigenschaften abrufen, kann dies zu mehr Netzwerkverkehr führen und die Cmdlet-Leistung beeinträchtigen.

  • 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

Geringfügige Änderungen

Inkonsistenter Parametername korrigiert.

Copy-CMCollection

Geringfügige Änderungen

Die Prüfung mit dem Parameter NewName wurde entsprechend der Konsole behoben.

Get-CMDeploymentStatusDetails

Geringfügige Änderungen

  • Problem bei der Überprüfung des Eingabeobjekttyps bei Typen wie SMS_DCMDeploymentErrorStatus, SMS_DCMDeploymentNonCompliantStatus und SMS_DCMDeploymentCompliantStatus behoben.
  • Problem mit der Ausgabe eines ungültigen Klassentyps behoben, indem der Ausgabeobjekttyp von SMS_AppDeploymentRequirementsNotMetStatus in SMS_AppDeploymentRequirementsNotMetAssetDetails geändert wurde.
  • Der Ausgabeobjekttyp wurde von SMS_AppDeploymentAssetDetails in SMS_AppDeploymentErrorAssetDetails geändert, um weitere Fehlerdetails abzurufen.
  • Eingabeobjekttyp SMS_UpdateDeploymentSummary hinzugefügt, damit mit diesem Cmdlet Details zur Updatebereitstellung abgerufen werden können. Beim Übergeben der Ausgabe von Get-CMSoftwareUpdateDeploymentStatus an Get-CMDeploymentStatusDetails werden die Bereitstellungsdetails aus SMS_SUMDeploymentAssetDetails zurückgegeben.

Get-CMDriver

Geringfügige Änderungen

Eine Funktion zum Filtern nach dem Parameter AdministrativeCategory wurde 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

Geringfügige Änderungen

Parameter PackageType zum Abrufen eines bestimmten Pakettyps hinzugefügt.

Get-CMSoftwareUpdateDeployment

Geringfügige Änderungen

Problem beim Bereitstellen von Updates ohne Paket behoben.

New-CMApplication

Behobene Fehler

Es wurde ein Softwarecenter-Anzeigeproblem bei der Installation von Apps behoben, die mit dem Zeitformat „jjjj/mm/tt“ erstellt wurden.

New-CMCertificateProfileScep

Behobene Fehler

Es wurde ein Problem mit dem Parameter SanType.

New-CMCollection

Geringfügige Änderungen

Die Prüfung mit dem Parameter Name wurde entsprechend der Konsole behoben.

New-CMOperatingSystemImage

Geringfügige Änderungen

Der Parameter Index wurde hinzugefügt. Wenn Sie diesen Parameter hinzufügen, extrahiert die Site ein einzelnes Indeximage aus einem Multiindeximage. Anschließend wird das neue Image in denselben Quellordner eingefügt, in dem sich das ursprüngliche Image befindet.

New-CMOperatingSystemInstaller

Geringfügige Änderungen

Der Parameter Index wurde hinzugefügt. Wenn Sie diesen Parameter hinzufügen, ersetzt die Website das aktuelle Multiindeximage durch ein neues einzelnes Indeximage.

New-CMTSRule

Geringfügige Änderungen

Der Parameter ReferencedVariableOperator verfügt über einen weiteren möglichen Wert: NotLike .

New-CMTSStepConditionVariable

Geringfügige Änderungen

Parameter OperatorType hat einen weiteren möglichen Wert: NotLike

New-CMSoftwareUpdateAutoDeploymentRule

Wichtige Änderungen

Ein Problem mit dem Parameter O365LanguageSelection wurde gelöst. Sie müssen nun eine Sprache mit einem Ländernamen angeben. Diese Änderung richtet diesen Parameter an den Optionen in der Configuration Manager-Konsole aus. Zum Beispiel, -O365LanguageSelection "English (United States)"

Set-CMCertificateProfileScep

Behobene Fehler

Es wurde ein Problem mit dem Parameter SanType.

Set-CMClientPushInstallation

Geringfügige Änderungen

Der Parameter AllownNTLMFallback wurde hinzugefügt, um NTLM-Fallbacks zu ermöglichen.

Set-CMCollection

Geringfügige Änderungen

Die Prüfung mit dem Parameter NewName wurde entsprechend der Konsole behoben.

Set-CMEmailProfile

Geringfügige Änderungen

  • Problem mit dem NewName-Parameter bei Angabe von sAMAccountName als Kontobenutzernamen behoben.
  • Problem mit einem Parameter bei der Auflösung von DomainName behoben.

Set-CMFallbackStatusPoint

Geringfügige Änderungen

Inkonsistenter Parametername korrigiert.

Set-CMThirdPartyUpdateCatalog

Geringfügige Änderungen

Die Parameter CategoryNamePublishOption und CategoryIdPublishOption wurden hinzugefügt. Sie können diese Parameter verwenden, um die Kategorieveröffentlichungsoption festzulegen, wenn Sie einen V3-Katalog abonnieren.

$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

Geringfügige Änderungen

Ein Problem wurde behoben, das aufgetreten ist, wenn der Parameter PublishOption auf FullContent festgelegt wurde.

Set-CMTSStep*

Beispiel: Set-CMTSStepApplyDataImage und 34 weitere ähnliche Cmdlets.

Geringfügige Änderungen

Parameter OperatorType hat einen weiteren möglichen Wert: NotLike

Set-CMSoftwareUpdateAutoDeploymentRule

Wichtige Änderungen

Ein Problem mit dem Parameter O365LanguageSelection wurde gelöst. Sie müssen nun eine Sprache mit einem Ländernamen angeben. Diese Änderung richtet diesen Parameter an den Optionen in der Configuration Manager-Konsole aus. Zum Beispiel, -O365LanguageSelection "English (United States)"

Bereitstellen von Feedback oder Melden von Problemen

Viele der in diesem Artikel beschriebenen Fehlerbehebungen 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.