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

Hinweis

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

Wichtige Änderungen

Dokumentationsbibliotheksupdates

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

Entfernte Cmdlets

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

• Add-CMNokiaDeploymentType

• Add-CMOutOfBandServicePoint

• Add-CMSystemHealthValidatorPoint

• Clear-CMAmtAuditLog

• Disable-CMAmtAuditLog

• Enable-CMAmtAuditLog

• Enable-CMAutomaticAmtProvisioning

• Get-CMAutomaticAmtProvisioningStatus

• Get-CMCmdletUpdateCheck

• Get-CMOutOfBandManagementComponent

• Get-CMOutOfBandServicePoint

• Get-CMSystemHealthValidatorPoint

• Get-CMSystemHealthValidatorPointComponent

• New-CMWiredProfileObject

• New-CMWirelessProfileObject

• Remove-CMAmtProvisioningData

• Remove-CMNokiaDeploymentType

• Remove-CMOutOfBandServicePoint

• Remove-CMSystemHealthValidatorPoint

• Send-CMCmdletUpdateCheck

• Set-CMCmdletUpdateCheck

• Set-CMNokiaDeploymentType

• Set-CMOutOfBandManagementComponent

• Set-CMOutOfBandServicePoint

• Set-CMSystemHealthValidatorPointComponent

• Update-CMAmtProvisioning

Unterstützung für das Importieren des ConfigurationManager-Moduls unter Verwendung des logischen Namens

Es gibt jetzt Unterstützung für das Importieren des ConfigurationManager-Moduls unter Verwendung eines logischen Namens oder Pfads.

Wenn der Pfad C:\Programme (x86)\Microsoft Configuration Manager\AdminConsole\bin oder ein gleichwertiger Pfad zur Variablen PSModulePath hinzugefügt wird, kann Folgendes verwendet werden:

Import-Module ConfigrationManager

Andernfalls kann Folgendes verwendet werden:

Import-Module 'C:\Program Files (x86)\Microsoft Configuration Manager\AdminConsole\bin\ConfigurationManager'

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

Neue Cmdlets

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

iOS-Registrierungsprofil

Es wurden neue Cmdlets zum Konfigurieren von iOS-Registrierungsprofilen hinzugefügt.

• Get-CMIosEnrollmentProfile

• New-CMIosEnrollmentProfile

• Remove-CMIosEnrollmentPRofile

• Set-CMIosEnrollmentProfile

Cmdlets für Das Cloudverwaltungsgateway

Es wurden neue Cmdlets zum Konfigurieren von Standortrollen des Cloudverwaltungsgateways hinzugefügt.

• Add-CMCloudManagementGatewayConnectionPoint

• Get-CMCloudManagementGateway

• Get-CMCloudManagementGatewayConnectionPoint

• New-CMCloudManagementGateway

• Remove-CMCloudManagementGateway

• Remove-CMCloudManagementGatewayConnectionPoint

• Set-CMCloudManagementGateway

• Set-CMCloudManagementGatewayConnectionPoint

• Start-CMCloudManagementGateway

• Stop-CMCloudManagementGateway

Data Warehouse-Dienstpunkt-Cmdlets

Es wurden neue Cmdlets zum Konfigurieren von Data Warehouse Service-Punktstandortrollen hinzugefügt.

• Add-CMDataWarehouseServicePoint

• Get-CMDataWarehouseServicePoint

• Remove-CMDataWarehouseServicePoint

• Set-CMDataWarehouseServicePoint

Bereitstellungs-Cmdlets

Es wurden mehrere neue Cmdlets geschrieben und Verbesserungen an Bereitstellungs- und Bereitstellungsüberwachungsszenarien vorgenommen.

Inhaltsverteilungsstatus

Get-CMDistributionStatus ist ein neues Cmdlet, mit dem der Verteilungsstatus eines beliebigen Inhaltsobjekts wie Anwendungen, Einstellungen oder Programmpakete abgerufen werden kann.

Abrufen von Bereitstellungen

Cmdlets wurden erstellt, um das Objekt abzurufen, das einer tatsächlichen Bereitstellung zugeordnet ist.

• Get-CMApplicationDeployment

• Get-CMBaselineDeployment

• Get-CMConfigurationPolicyDeployment

• Get-CMPackageDeployment

• Get-CMSoftwareUpdateDeployment

• Get-CMTaskSequenceDeployment

Bereitstellungserstellung

Cmdlets wurden zum Erstellen neuer Bereitstellungen erstellt. Diese Cmdlets ersetzt bereits vorhandene Start-CM*Bereitstellungs-Cmdlets.

• New-CMApplicationDeployment

• New-CMBaselineDeployment

• New-CMConfigurationPolicyDeployment

• New-CMPackageDeployment

• New-CMSoftwareUpdateDeployment

• New-TaskSequenceDeployment

Verbesserte Unterstützung der Objektpipeline

Set-CM*Deployment, Remove-CM*Deployment und Get-CM*DeploymentStatus unterstützen jetzt die Objektpipeline vollständig.

Start-CM-Featurebereitstellungs-Cmdlets<>sind veraltet

Die folgenden Cmdlets für die Bereitstellung des Start-CM-Features<>sind veraltet. Die Ersetzungs-Cmdlets können sich in den Parameternamen unterscheiden, sollten aber über eine identische und in einigen Fällen verbesserte Funktionalität verfügen.

• Start-CMApplicationDeployment (ersetzt durch New-CMApplicationDeployment)

• Start-CMPackageDeployment (ersetzt durch New-CMPackageDeployment)

• Start-CMBaselineDeployment (ersetzt durch New-CMBaselineDeployment)

• Start-CMConfigurationPolicyDeployment (ersetzt durch New-CMConfigurationPolicyDeployment)

• Start-CMTaskSequenceDeployment (ersetzt durch New-CMTaskSequenceDeployment)

• Start-CMSoftwareUpdateDeployment (ersetzt durch New-CMSoftwareUpdateDeployment)

Get-CMResultantSettings

Dieses Cmdlet ruft die resultierenden Clienteinstellungen für eine Sammlung, ein Gerät oder einen Benutzer ab.

Updates des Betriebssystemupgradepakets

Es wurden neue Cmdlets zum Erstellen und Ändern von Updatezeitplänen für Betriebssystemupgradepakete hinzugefügt.

• Clear-CMOperatingSystemUpgradeUpdateSchedule

• Get-CMOperatingSystemUpgradeUpdateSchedule

• New-CMOperatingSystemUpgradeUpdateSchedule

• Remove-CMOperatingSystemUpgradeUpdateSchedule

Remove-CMSoftwareUpdateFromGroup

Dieses Cmdlet entfernt ein Softwareupdate aus einer Softwareupdategruppe.

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.

Verschiedene Änderungen

Behobene Fehler

Große SMS_EmbeddedPropertyList Objekte, die von bestimmten Anbieterklassen verwendet werden, werden möglicherweise nicht ordnungsgemäß vom Cmdlet-Framework genutzt, was beim Abrufen oder Festlegen dieser Werte zu einem nicht definierten Verhalten führt.

Bestimmte Kombinationen von Änderungen an Antischadsoftwarerichtlinien oder Clienteinstellungen können dazu führen, dass eine ungültige Richtlinie generiert wird. In diesem Zustand gibt der SMS-Anbieter den Fehler "Instanz ist keine gültige Client-Agent-Konfiguration" zurück.

Cmdlets zum Konfigurieren von Verwaltungspunkten und Softwareupdatepunkten haben den Parameter EnableCloudGateway hinzugefügt, um diese Rollen für die Verwendung mit dem Cloudverwaltungsgateway zu aktivieren.

Konfiguration des Standortwartungsfensters

Unterbrechungsfreie Änderungen

CMMaintenanceWindow-Cmdlets unterstützen jetzt die Konfiguration von Wartungsfenstern für Standorte. Die Ausgabe von Get-CMSite kann in New, Remove oder Set-CMMaintenanceWindow weitergeleitet werden, um die Wartungsfenster für einen Standort zu konfigurieren.

Add-CMDeploymentType

Breaking Changes

Die Unterstützung für das Erstellen von Nokia-Bereitstellungstypen wurde entfernt.

Add-CMDeviceAfinityToUser

Behobene Fehler

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

Add-CMDistributionPoint

Behobene Fehler

Mit dem Cmdlet können Sie einen Verteilungspunkt als internetfähig konfigurieren, wenn HTTPS nicht aktiviert ist.

Unterbrechungsfreie Änderungen

AllowProxyTraffic-Parameter hinzugefügt.

Der zuvor nicht verwendete InstallInternetServer-Parameter ändert nun die Konfiguration des Verteilungspunkts.

Veraltete Funktionen

Der UseComputerAccount-Parameter ist veraltet. Um ein Computerkonto zu verwenden, legen Sie UserName auf $null fest.

Add-CMEnrollmentPoint

Behobene Fehler

Die Registrierungspunktrolle enthält keine Konfigurationseinstellungen im erstellten Objekt.

Add-CMEnrollmentProxyPoint

Unterbrechungsfreie Änderungen

Der ServiceHost-Parameter wurde hinzugefügt, um die Angabe eines Remoteregistrierungspunkts zu ermöglichen.

Add-CMIntuneSubscription

Behobene Fehler

Der ContactEmail-Parameter kann nicht auf NULL oder einen leeren Wert festgelegt werden.

Add-CMMulticastServicePoint

Behobene Fehler

UserName überprüft nicht auf die richtige DOMAIN\user-Formatierung.

Die Parameter StartUdpPort und EndUdpPort überprüfen keine Werte für bestimmte falsche Konfigurationen.

Die Parameter StartIPAddress und EndIPAddress überprüfen keine Werte für bestimmte falsche Konfigurationen.

Unterbrechungsfreie Änderungen

UseAnyRangeIP-Parameter hinzugefügt.

Veraltete Funktionen

Der ClientTransferRate-Parameter wird nicht mehr unterstützt.

Approve-CMUserDeviceAffinityRequest

Behobene Fehler

Das Cmdlet ermöglicht das Genehmigen einer zuvor verarbeiteten Affinitätsanforderung.

Convert-CMSchedule

Behobene Fehler

Der InputObject-Parameter akzeptiert kein weitergeleitetes Zeitplanobjekt.

Deny-CMUserDeviceAffinityRequest

Behobene Fehler

Das Cmdlet ermöglicht das Ablehnen einer zuvor verarbeiteten Affinitätsanforderung.

Get-CMAlert

Behobene Fehler

Clientintegritäts- oder Endpoint Protection-Warnungen können nicht abgerufen werden.

Get-CMSiteStatusMessage

Unterbrechungsfreie Änderungen

Die Parameter ComputerName, Severity und SiteCode akzeptieren jetzt Arraywerte.

Die Parameter MessageId, Module, Component und FilterHashTable wurden für weitere Filter hinzugefügt.

Alle zeichenfolgenbasierten Filterparameter akzeptieren jetzt Platzhalter.

Get-CMWindowsEnrollmentProfilePackage

Behobene Fehler

Cmdlet kann nicht ohne Parameter angegeben werden.

Import-CMComputerInformation

Breaking Changes

Beim Cmdlet tritt ein Fehler auf, wenn ein Datensatz importiert wird, der bereits vorhanden ist und der neue MergeIfExist-Parameter nicht angegeben wird.

Import-CMDriver

Behobene Fehler

Wenn ImportFolder verwendet wird, verbrauchen Treiberpakete möglicherweise mehr Speicherplatz als erwartet.

Install-CMClient

Unterbrechungsfreie Änderungen

Unterstützung für Pipelineobjekte aus Get-CMDevice und Get-CMResource hinzugefügt.

Invoke-CMRemoteControl

Behobene Fehler

Das Cmdlet akzeptiert kein weitergeleitetes Objekt von Get-CMSiteSystemServer.

Ein Standortsystemserver kann nicht als Ziel für die Remotesteuerung verwendet werden, wenn es sich nicht auch um einen Clientcomputer handelt.

New-CMActiveDirectoryForest

Unterbrechungsfreie Änderungen

Der UserName-Parameter wurde hinzugefügt, um die Konfiguration des Ermittlungskontos zu ermöglichen.

AddPublishingSite-Parameter hinzugefügt.

New-CMApplicationDeployment

Unterbrechungsfreie Änderungen

UpdateSupersedence-Parameter hinzugefügt.

New-CMBoundaryGroup

Breaking Changes

FastLink ist der einzige unterstützte Wert für die Hashtabelle im AddSiteSystemServer-Parameter . Die Unterstützung für alle anderen Werte wurde entfernt.

New-CMCertificateProfilePfx

Behobene Fehler

Der KeyStorageProvider-Parameterwert wird möglicherweise nicht wie erwartet auf das neu erstellte Zertifikatprofil angewendet.

New-CMGlobalCondition

Breaking Changes

Die Unterstützung für die Erstellung globaler Nokia-Bedingungen wurde entfernt.

New-CMProgram

Unterbrechungsfreie Änderungen

AddSupportedOperatingSystemPlatform-Parameter hinzugefügt.

New-CMSoftwareUpdateAutoDeploymentRule

Behobene Fehler

Der MicrosoftAsVendor-Parameterwert wird möglicherweise nicht auf die Regel angewendet.

Unterbrechungsfreie Änderungen

Der Vendor-Parameter wurde hinzugefügt, um Patches von Drittanbietern zu unterstützen.

GenerateFailureAlert-Parameter hinzugefügt.

New-CMSoftwareUpdateDeployment

Unterbrechungsfreie Änderungen

Der RequirePostRebootFullScan-Parameter wurde hinzugefügt.

New-CMStandaloneMedia

Unterbrechungsfreie Änderungen

Die Parameter MediaStartDate und MediaExpirationDate wurden hinzugefügt, um den Medienablauf zu unterstützen.

Die Parameter Application, DriverPackage und Package zum Hinzufügen zusätzlicher Medieninhalte wurden hinzugefügt.

New-CMStatusMessageQuery

Behobene Fehler

Die erstellte Abfrage wird möglicherweise nicht am erwarteten Speicherort der Administratorkonsole angezeigt.

New-CMWindowsEnrollmentProfile

Behobene Fehler

Der EnrollmentProxyPoint-Parameter kann auf einen NULL-Wert oder einen leeren Wert festgelegt werden.

Der Wert des SiteCode-Parameters kann dazu führen, dass in der Administratorkonsole ein Validierungsfehler auftritt.

Remove-CMResource

Behobene Fehler

Durch das Entfernen einer Ressource werden keine Statusmigrationszuordnungen entfernt.

Remove-CMWindowsEnrollmentProfilePackage

Behobene Fehler

Der Fehler AmbiguousParameterSet kann beim Ausführen des Cmdlets ausgelöst werden.

Set-CMActiveDirectoryForest

Unterbrechungsfreie Änderungen

Der UserName-Parameter wurde hinzugefügt, um die Konfiguration des Ermittlungskontos zu ermöglichen.

Die Parameter AddPublishingSite und RemovePublishingSite wurden hinzugefügt.

Set-CMAdvancedThreatProtectionPolicy

Behobene Fehler

Das Erhöhen oder Verringern der Priorität kann dazu führen, dass ein ObjectNotFound-Fehler zurückgegeben wird.

Set-CMAntimalwarePolicy

Behobene Fehler

WhatIf zeigt möglicherweise nicht den erwarteten Richtliniennamen an.

Die Echtzeitschutzeinstellungen können nicht geändert werden, wenn ein pipelinefähiges Objekt verwendet wird.

Unterbrechungsfreie Änderungen

Das Cmdlet akzeptiert jetzt weitergeleitete Eingaben von Get-CMAntimalwarePolicy.

Set-CMApplication

Unterbrechungsfreie Änderungen

Die Parameter AddSupportContact, AddOwner, RemoveSupportContact, RemoveOwner, ClearSupportContact und ClearOwner wurden hinzugefügt, um direkte Änderungen von Supportkontakten oder -besitzern zu unterstützen.

Set-CMAppVVirtualEnvironment

Behobene Fehler

PassThru gibt nicht das aktuellste Objekt zurück.

Set-CMBaseline

Behobene Fehler

PassThru gibt kein SMS_ConfigurationItem-Objekt zurück.

Unterbrechungsfreie Änderungen

ClearRequiredConfigurationItem, ClearProhibitedConfigurationItem, ClearOptionalConfigurationItem, ClearOSConfigurationItem, ClearSoftwareUpdate, ClearBaseline, RemoveRequiredConfigurationItem, RemoveOptionalConfigurationItem, RemoveProhibitedConfigurationItemRemoveOSConfigurationItem, RemoveSoftwareUpdate, RemoveBaseline, AddSoftwareUpdate- und AddBaseline-Parameter.

Set-CMBoundaryGroup

Breaking Changes

FastLink ist der einzige unterstützte Wert für die Hashtabelle im AddSiteSystemServer-Parameter . Die Unterstützung für alle anderen Werte wurde entfernt.

Set-CMCertificateProfileTrustedRootCA

Behobene Fehler

Die Verwendung der Objektpipeline kann zu einem ParameterBindingException-Fehler führen.

Set-CMClientPushInstallation

Unterbrechungsfreie Änderungen

Die Parameter AddAccount und RemoveAccount wurden hinzugefügt, um direkte Änderungen von Clientpushkonten zu unterstützen.

Set-CMClientSettingComputerAgent

Behobene Fehler

Der HealthAttestationUrl-Parameterwert ist nicht erforderlich, wenn EnableHealthAttestation oder UseOnPremisesHealthAttestation auf true festgelegt sind.

Set-CMComputerAssociation

Unterbrechungsfreie Änderungen

Der Parameter MigrationId wurde hinzugefügt.

Set-CMDeploymentType

Breaking Changes

Die Unterstützung für das Ändern von Nokia-Bereitstellungstypen wurde entfernt.

Set-CMDiscoveryMethod

Behobene Fehler

Der PollingSchedule-Wert wird möglicherweise nicht ordnungsgemäß auf die Ermittlungsmethode angewendet.

Set-CMDistributionPoint

Behobene Fehler

Mit dem Cmdlet können Sie einen Verteilungspunkt als internetfähig konfigurieren, wenn HTTPS nicht aktiviert ist.

Unterbrechungsfreie Änderungen

AllowProxyTraffic-Parameter hinzugefügt.

Der zuvor nicht verwendete InstallInternetServer-Parameter ändert nun die Konfiguration des Verteilungspunkts.

Veraltete Funktionen

Der UseComputerAccount-Parameter ist veraltet. Um ein Computerkonto zu verwenden, legen Sie UserName auf $null fest.

Set-CMEmailNotificationComponent

Unterbrechungsfreie Änderungen

UseSsl-Parameter hinzugefügt.

Set-CMFileReplicationRoute

Behobene Fehler

Der FileReplicationAccountName-Parameter kann nicht auf NULL oder einen leeren Wert festgelegt werden.

Set-CMHierarchySetting

Unterbrechungsfreie Änderungen

Die Parameter ExclusionCollection, ExclusionCollectionId, ExclusionCollectionName und EnableExclusionCollection zum Konfigurieren von Clientupgradeausschlüssen wurden hinzugefügt.

Set-CMIntuneSubscription

Behobene Fehler

Der ContactEmail-Parameter kann nicht auf NULL oder einen leeren Wert festgelegt werden.

Unterbrechungsfreie Änderungen

Der Parameter MaximumUserDevice unterstützt jetzt einen Wert zwischen 1 und 15.

Set-CMIntuneSubscriptionWindowsPhoneProperty

Behobene Fehler

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

Set-CMMaintenanceTask

Behobene Fehler

Der PassThru-Parameter bewirkt nicht, dass ein Objekt zurückgegeben wird.

Set-CMMulticastServicePoint

Behobene Fehler

Der UserName-Parameter überprüft den Wert nicht für die richtige DOMAIN\user-Formatierung.

Die Parameter StartUdpPort und EndUdpPort überprüfen keine Werte für bestimmte falsche Konfigurationen.

Die Parameter StartIPAddress und EndIPAddress überprüfen keine Werte für bestimmte falsche Konfigurationen.

Unterbrechungsfreie Änderungen

UseAnyRangeIP-Parameter hinzugefügt.

Veraltete Funktionen

Der ClientTransferRate-Parameter wird nicht mehr unterstützt.

Set-CMProgram

Unterbrechungsfreie Änderungen

Die Parameter AddSupportedOperatingSystemPlatform, RemoveSupportedOperatingSystemPlatform und RunOnAnyPlatform wurden hinzugefügt.

Set-CMSite

Behobene Fehler

RemoveClientRequestServiceType entfernt den angegebenen Wert möglicherweise nicht ordnungsgemäß.

Unterbrechungsfreie Änderungen

Die Parameter SiteSystemCollectionBehavior, ThresholdOfSelectCollectionMax, ThresholdOfSelectCollectionByDefault und ThresholdOfSelectCollectionMax wurden hinzugefügt, um Schwellenwerte für die Gerätesammlung für eine Website zu konfigurieren.

Set-CMSiteSummaryTask

Behobene Fehler

Der PassThru-Parameter bewirkt nicht, dass ein Objekt zurückgegeben wird.

Set-CMSoftwareUpdateAutoDeploymentRule

Behobene Fehler

Der MicrosoftAsVendor-Parameterwert wird möglicherweise nicht auf die Regel angewendet.

Unterbrechungsfreie Änderungen

Der Vendor-Parameter wurde hinzugefügt, um Patches von Drittanbietern zu unterstützen.

GenerateFailureAlert-Parameter hinzugefügt.

Set-CMSoftwareUpdateDeployment

Unterbrechungsfreie Änderungen

Der RequirePostRebootFullScan-Parameter wurde hinzugefügt.

Set-CMSoftwareUpdatePointComponent

Behobene Fehler

Die Verwendung von Parametern "EnableSynchronization " und "Zeitplan " kann dazu führen, dass eine falsche Warnung generiert wird oder der Zeitplan nicht wie erwartet geändert wird.

Set-CMStatusFilterRule

Behobene Fehler

Änderungen am Prioritätsparameterwert gelten möglicherweise nicht für die Statusfilterregel.

Set-CMTaskSequence

Veraltete Funktionen

Der UseDefaultText-Parameter ist veraltet. Um den Standardtext zu verwenden, legen Sie CustomText auf $null fest.

Set-CMWindowsEnrollmentProfile

Behobene Fehler

Der Autoritätsparameter ist nicht in allen Parametersätzen verfügbar.