Freigeben über

Änderungen der Configuration Manager Cmdlet-Bibliothek für Current Branch 1710

  • Artikel

Hinweis

System Center Configuration Current Branch 1706 ist die Baseline für diese Änderungen. Weitere Informationen finden Sie Configuration Manager Änderungen der Cmdlet-Bibliothek für Current Branch 1706.

Wichtige Änderungen

Updates der Dokumentationsbibliothek

Die neueste Dokumentation zur Cmdlet-Bibliothek finden Sie unter ConfigurationManager-Modulreferenz.

Entfernte Cmdlets

Die folgenden Cmdlets werden nicht mehr unterstützt und wurden entfernt:

  • Invoke-CMAmtProvisioningDiscovery
  • New-CMAmtProvisioningAccount
  • Set-CMPowerControl

Veraltete Cmdlets

  • Invoke-CMEndpointProtectionScan und Save-CMEndpointProtectionDefinition wurden durch Invoke-CMClientActionersetzt.

Deaktivieren der automatischen PSDrive-Erstellung

Wenn das Modul ConfigurationManager.psd1 geladen wird, versucht PowerShell automatisch, eine Verbindung mit dem letzten SMS-Anbieter herzustellen, auf den über die Configuration Manager-Konsole zugegriffen wurde. In einigen Szenarien ist dieses Verhalten möglicherweise nicht wünschenswert. Es wurde ein Benutzerregistrierungsschlüssel hinzugefügt, der dieses Verhalten deaktivieren kann und die manuelle Laufwerkerstellung erfordert. Um dies zu konfigurieren, verwenden Sie den Registrierungsschlüssel, HKEY_CURRENT_USER\Software\Microsoft\ConfigMgr10\PowerShell und legen Sie den Wert auf einen DWORD-Wert DisableCMDriveAutoCreate von 1 (automatische Laufwerkerstellung ist deaktiviert) oder 0 (Standardverhalten) fest. Durch löschen DisableCMDriveAutoCreate wird auch das Standardverhalten aktiviert.

Hinweis

Wenn die automatische Laufwerkerstellung deaktiviert ist, kann die Configuration Manager-Konsole beim Starten eines PowerShell-Fensters einen Fehler melden.

Bekannte Probleme

Dies sind bekannte Probleme mit der Cmdlet-Bibliothek, die in dieser Version nicht behoben wurden.

Get-CMAadConditionalAccessPolicy und Set-CMAadConditionalAccessPolicy

Für diese Cmdlets ist eine 64-Bit-PowerShell-Umgebung erforderlich.

Problemumgehung

  • Keine

Import-CMSecurityRole

Das Cmdlet schlägt möglicherweise mit einem DirectoryNotFoundException-Fehler fehl, der die Datei SecuredRoles.xsdauffindt.

Problemumgehung

Stellen Sie sicher, dass Import-Module für die ConfigurationManager.psd1 Datei und nicht für den logischen Pfad oder Modulnamen aufgerufen wird.

Get-CMSiteUpdateInstallStatus

Das Cmdlet schlägt möglicherweise mit einem WqlQueryException-Fehler fehl.

Problemumgehung

  • Verwenden Sie Invoke-CMWmiQuery, um die SMS_CM_UpdatePackTopLevelMonitoring-Klasse direkt abzufragen.
Beispiel
# Note: The PackageGuid value can be determined by running Get-CMSiteUpdateInstallStatus -Verbose and viewing the query details.
Invoke-CMWmiQuery "SELECT * FROM SMS_UpdatePackTopLevelMonitoring WHERE PackageGuid='...' ORDER BY StageId ASC"

Set-CMSoftwareUpdatePoint

Änderungen am Zeitplan werden möglicherweise nicht in der Configuration Manager-Konsole wider, obwohl das zugrunde liegende SMS-Anbieterobjekt geändert wurde.

Problemumgehung

Beenden Sie die Configuration Manager-Konsole, und starten Sie sie neu.

Neue Cmdlets

Dies sind neu hinzugefügte Cmdlets für dieses Release, die neue Funktionen hinzufügen oder die Funktionalität vorhandener Cmdlets verbessern.

Gerätezuordnungs-Cmdlets

Get-CMResultantCollection ruft die einem Gerät zugeordneten Sammlungen ab. Get-CMResultantDeployment ruft die Bereitstellungen für ein Gerät ab.

Clientinventurklassenverwaltung

Neue Cmdlets wurden hinzugefügt, um das Ändern von Bestandsklassen zu unterstützen, die für die Clientinventur verwendet werden.

  • Get-CMInventoryClass
  • New-CMInventoryReportClass

Tasksequenzen

Neue Cmdlets wurden hinzugefügt, um das Ändern von Tasksequenzschritten zu unterstützen.

  • Tasksequenzbefehle (Die Verben Get, New, Remove und Set werden unterstützt)
    • CMTaskSequenceStepApplyOperatingSystem
    • CMTaskSequenceStepApplyWindowsSetting

Ressourcennachverfolgung und -wiederherstellung (BETA)

Neue Cmdlets wurden hinzugefügt, um die Nachverfolgung von SMS-Anbieterobjekten zu unterstützen, die von der PowerShell-Runtime verwendet werden, und um diese Ressourcen zu bereinigen, wenn sie nicht mehr benötigt werden.

  • Disconnect-CMTrackedObject
  • Start-CMObjectTracking
  • Stop-CMObjectTracking

Wenn Start-CMObjectTracking ausgeführt wird, verfolgt die PowerShell-Runtime Objekte nach IResultObject , die von Cmdlet-Bibliotheks-Cmdlets erstellt wurden. Cmdlets, die nicht manuell mit bereinigt .Dispose() werden, können mithilfe von Disconnect-CMTrackedObject für ein einzelnes Objekt freigegeben werden.

Beispiel

# Reclaim all tracked objects
$o | Disconnect-CMTrackedObject```), or ```Disconnect-CMTrackedObject -All

Beachten Sie, dass ein Objekt, nachdem es freigegeben wurde, nicht mehr wiederverwendet oder über die Objektpipeline an ein anderes Cmdlet übergeben werden kann.

Stop-CMObjectTracking kann verwendet werden, um die Objektnachverfolgung zu deaktivieren. Beachten Sie, dass zuvor zugeordnete Objekte aktiv bleiben.

Nicht beanspruchte Ressourcen können dazu führen, dass fehler aufgrund von Kontingentverletzungen vom SMS-Anbieter ausgelöst werden. Diese Probleme treten in der Regel auf die Arbeit mit sehr großen Gruppen von SMS-Anbieterobjekten oder in Umgebungen mit sehr langer Ausführungsdauer auf.

Hinweis

Dies ist ein experimentelles Feature und kann in einer zukünftigen Version geändert oder entfernt werden. Dieses Feature ist aktiviert und nicht standardmäßig aktiviert.

Cmdlet-Änderungen

Die folgenden Änderungen wurden an vorhandenen Cmdlets für dieses Release vorgenommen. Änderungen können neue Funktionen, Fehlerbehebungen oder veraltete Funktionen sein und möglicherweise nicht mehr verwendet werden. 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.

Complianceeinstellungs- und Regel-Cmdlets

Behobene Fehler

Der RuleDescription-Wert gilt möglicherweise nicht für die Regel. (Cmdlets, die das Erstellen oder Ändern von Regeln unterstützen)

Der Wert für den Registrierungsschlüssel "default" kann nicht festgelegt werden (Add/Set-CMComplianceSettingRegistryKeyValue, New-CMDetectionClauseRegistryKeyValue).

NullReferenceException kann ausgelöst werden (New-CMComplianceRuleAssembly)

Fehlende DataType-Unterstützung (Add-CMComplientSettingREgistryKeyValue)

Add-CMApplicationCatalogWebsitePoint

Behobene Fehler

Verbesserte Fehlerbehandlung und -berichterstellung.

Add/Set-CMDataWarehouseServicePoint

Unterbrechungsfreie Änderungen

DataWarehouseSqlPort unterstützt den Portwert von 1 bis 65535. Der DaysOfWeek-Parameter unterstützt jetzt den Wert von Daily.

Add/Set-CMExchangeServer

Behobene Fehler

Der Parameterwert "EmailAddress " gilt möglicherweise nicht für die Exchange-Serverkonfiguration.

Add-CMMsiDeploymentType

Behobene Fehler

Der ContentLocation-Parameter ist erforderlich, wenn die Skripterkennung verwendet wird. Neue UninstallContentLocation - und UninstallOption-Parameter hinzugefügt.

Unterbrechungsfreie Änderungen

Verbesserte Validierung für den ProductCode-Parameter .

Add-CMScriptDeploymentType

Unterbrechungsfreie Änderungen

Verbesserte Validierung für den ProductCode-Parameter . Neue UninstallContentLocation - und UninstallOption-Parameter hinzugefügt.

Get-CMDeploymentTypeDependencyGroup

Unterbrechungsfreie Änderungen

Das Cmdlet unterstützt jetzt den pipelineierten Wert von Get-CMDeploymentType.

Get-CMSiteStatusMessage

Behobene Fehler

Beim Filtern mit dem Schweregradparameter werden nicht alle Nachrichten zurückgegeben.

Invoke-CMClientAction (früher Invoke-CMClientNotification)

Unterbrechungsfreie Änderungen

ActionType-Parameter , der alle Clientbenachrichtigungstypen akzeptiert.

Hinweis

RequestScriptExecution wird derzeit nicht unterstützt.

Veraltete Funktionen

NotificationType wurde durch ActionType ersetzt.

New-CM*-Bereitstellung

Behobene Fehler

Das Cmdlet ermöglicht das Kombinieren der Parameter CollectionId, CollectionName und Collection , was zu nicht definiertem Verhalten führen kann.

New-CMBootableMedia

Behobene Fehler

Medien können nicht als SiteBased erstellt werden.

New-CMWirelessProfile

Behobene Fehler

Das Cmdlet kann in einer 64-Bit-PowerShell-Umgebung nicht ausgeführt werden.

Das Cmdlet gibt möglicherweise einen Fehler zurück, wenn ein Wert für den Parameter ClientCertificate angegeben wird.

Remove-CMCorpOwnedDevice

Behobene Fehler

Das Gerät kann nicht entfernt werden, wenn ein pipelinefähiges Objekt verwendet wird.

Der Gerätename wird bei Verwendung von WhatIf oder Confirm nicht gemeldet.

Remove-CMStateMigrationPoint

Breaking Changes

Wenn auf dem Zustandsmigrationspunkt Benutzerdaten gespeichert sind, ist eine zusätzliche Bestätigung erforderlich. Hinweis: Die Erzwingung umgeht diese Bestätigung.

Save-CMSoftwareUpdate

Unterbrechungsfreie Änderungen

Die Parameter RetryCount und RetryDelaySec wurden hinzugefügt, um Downloads nach einem Fehler erneut zu überprüfen.

Set-CMAccessAccount

Behobene Fehler

PassThru gibt möglicherweise kein aktualisiertes Objekt zurück.

Set-CMAntimalwarePolicy

Behobene Fehler

Mit dem AddExcludedFilePath-Parameter können keine Wildcardzeichen verwendet werden.

Konfiguration FallbackOrder für eine bestimmte Richtlinie nicht möglich

Unterbrechungsfreie Änderungen

Neue Parameter für die Verwaltung von Bedrohungslisten hinzugefügt: AddThreat, RemoveThreat und CleanThreat. AddThreat akzeptiert eine Hashtabelle mit dem Schlüssel als Name und dem Wert vom Typ Microsoft.ConfigurationManagement.Cmdlets.EP.Commands.DefaultActionMediumAndLowType.

Veraltete Funktionen

Die Parameter ThreatName und OverrideAction wurden durch AddThreat, RemoveThreat und CleanThreat ersetzt.

Set-CMClientSettingComputerAgent

Veraltete Funktionen

HealthAttestationUrl-Parameter , da er nicht mehr vom Produkt verwendet wird.

Set-CMClientSettingHardwareInventory

Unterbrechungsfreie Änderungen

Die Parameter AddInventoryReportClass, CleanInventoryReportClass und RemoveInventoryReportClass unterstützen das Ändern des von Clients gesammelten Hardwarebestands.

Set-CMMsiDeploymentType

Unterbrechungsfreie Änderungen

Verbesserte Validierung für den ProductCode-Parameter .

Set-CMScriptDeployment

Behobene Fehler

Das Anwendungsobjekt im SMS-Anbieter wird möglicherweise nicht automatisch entsperrt, wenn das Cmdlet fehlschlägt und weitere Änderungen verhindert, bis die Sperre abläuft.

Set-CMScriptDeploymentType

Unterbrechungsfreie Änderungen

Verbesserte Validierung für den ProductCode-Parameter .

Set-CMSoftwareUpdatePointComponent

Unterbrechungsfreie Änderungen

Neuer ContentFileOption-Parameter zum Konfigurieren des Updatedownloadverhaltens hinzugefügt.

Set-CMSiteMaintenanceTask

Unterbrechungsfreie Änderungen

Verbesserte Fehlerberichterstattung

Set-CMWirelessProfile

Behobene Fehler

Das Cmdlet kann in einer 64-Bit-PowerShell-Umgebung nicht ausgeführt werden.

Der Fehler MismatchedPSTypeName kann ausgelöst werden, wenn die Objektpipeline verwendet wird.

ProxyAddress und ProxyPort werden nicht mit den gleichen Regeln wie die Configuration Manager-Konsole überprüft.

Die Angabe von ProxyAddress ohne ProxyPort kann dazu führen, dass eine ungültige Konfiguration erstellt wird.

SecurityAuthentication kann mit Konfigurationen geändert werden, die dies nicht unterstützen.

EapType muss mit SecurityAuthentication kombiniert werden, auch wenn sich letzteres nicht ändert.

Unterbrechungsfreie Änderungen

Die Parameter RootCertificate, ClientCertificate und RememberCredentials wurden hinzugefügt.

Verbesserte Funktionalität zum Konfigurieren einer MSCHAPv2-Drahtlosrichtlinie.

Sync-CMSoftwareUpdate

Unterbrechungsfreie Änderungen

Für das Cmdlet müssen keine Parameter mehr angegeben werden.

Hinweis

Wenn keine Parameter definiert sind, -ForceSync $true wird impliziert.