Änderungen Configuration Manager Cmdlet-Bibliothek für Version 2002

  • Artikel

Gilt für: Configuration Manager (Current Branch)

Hinweis

Configuration Manager aktuelle Verzweigungsversion 1910 ist der Basisplan für diese Änderungen. Weitere Informationen finden Sie unter Configuration Manager Änderungen der Cmdlet-Bibliothek für Version 1910.

Wichtige Änderungen

Neue Cmdlets

New-CMSoftwareUpdatePhase

Verwenden Sie dieses Cmdlet, um eine Bereitstellungsphase für Softwareupdates zu erstellen.

New-CMSoftwareUpdatePhase `
 -CollectionName "MyCollection" `
 -PhaseName "MySUPhase"`
 -UserNotificationOption DisplaySoftwareCenterOnly

New-CMTaskSequencePhase

Verwenden Sie dieses Cmdlet, um eine Bereitstellungsphase für eine Tasksequenz zu erstellen.

New-CMTaskSequencePhase -CollectionName "MyCollection" -PhaseName "MyTSPhase" -UserNotification DisplayAll -AllowRemoteDP $true

Get-CMPhase

Verwenden Sie dieses Cmdlet, um die Bereitstellungsphase für eine bestimmte Instanz oder eine phasenweise Bereitstellung abzurufen.

Get-CMPhase -Id "66DEDF86-D0CB-457D-88BE-47E3FAC92A47"
$myPhasedDeployment | Get-CMPhase

New-CMApplicationAutoPhasedDeployment

Verwenden Sie dieses Cmdlet, um eine phasenweise Bereitstellung für eine Anwendung zu erstellen, indem Sie zwei Phasen mit denselben Einstellungen generieren.

New-CMApplicationAutoPhasedDeployment -ApplicationName "myApp" -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"
 
$myApp | New-CMApplicationAutoPhasedDeployment -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"

New-CMSoftwareUpdateAutoPhasedDeployment

Verwenden Sie dieses Cmdlet, um eine phasenweise Bereitstellung für Softwareupdates zu erstellen, indem Sie zwei Phasen mit denselben Einstellungen generieren.

New-CMSoftwareUpdateAutoPhasedDeployment -SoftwareUpdateName "myUpdateName" -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"
$myUpdate | New-CMSoftwareUpdateAutoPhasedDeployment -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"

New-CMSoftwareUpdateManualPhasedDeployment

Verwenden Sie dieses Cmdlet, um eine phasenweise Bereitstellung für Softwareupdates zu erstellen. Sie müssen zuerst neue benutzerdefinierte Bereitstellungsphasen mit dem Cmdlet New-CMSoftwareUpdatePhase hinzufügen.

$phase1 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM001" -PhaseName "test01" -UserNotificationOption DisplaySoftwareCenterOnly
$phase2 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM003" -PhaseName "test02" -UserNotificationOption DisplaySoftwareCenterOnly
New-CMSoftwareUpdateManualPhasedDeployment -SoftwareUpdateNames ("myUpdateA", "myUpdateB") -Name "myPhaseDeployment" -AddPhases ($phase1, $phase2)
 
$phase3 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM001" -PhaseName "test03" -UserNotificationOption DisplaySoftwareCenterOnly
$phase4 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM003" -PhaseName "test04" -UserNotificationOption DisplaySoftwareCenterOnly
New-CMSoftwareUpdateManualPhasedDeployment -SoftwareUpdateGroupName "myGroup" -Name "myPhaseDeploymentForGroup" -AddPhases ($phase3, $phase4)

New-CMTaskSequenceAutoPhasedDeployment

Verwenden Sie dieses Cmdlet, um eine phasenweise Bereitstellung für eine Tasksequenz zu erstellen, indem Sie zwei Phasen mit denselben Einstellungen generieren.

New-CMTaskSequenceAutoPhasedDeployment -TaskSequenceName "myTaskSequenceName" -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"
 
$myTS | New-CMTaskSequenceAutoPhasedDeployment -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"

New-CMTaskSequenceManualPhasedDeployment

Verwenden Sie dieses Cmdlet, um eine phasenweise Bereitstellung für eine Tasksequenz zu erstellen. Sie müssen zuerst neue benutzerdefinierte Bereitstellungsphasen mit dem Cmdlet New-CMTaskSequencePhase hinzufügen.

$phase1 = New-CMTaskSequencePhase -CollectionId "SMSDM001" -PhaseName "test01" -UserNotification DisplayAll
$phase2 = New-CMTaskSequencePhase -CollectionId "SMSDM003" -PhaseName "test02" -UserNotification HideAll
New-CMTaskSequenceManualPhasedDeployment -TaskSequenceName "myTaskSequence" -Name "phasedDeployment" -AddPhases ($phase1, $phase2)
 
$phase3 = New-CMTaskSequencePhase -CollectionId "SMSDM001" -PhaseName "test03" -UserNotification DisplayAll
$phase4 = New-CMTaskSequencePhase -CollectionId "SMSDM003" -PhaseName "test04" -UserNotification HideAll
$myTaskSequence | New-CMTaskSequenceManualPhasedDeployment -Name "phasedDeployment" -AddPhases ($phase3, $phase4)

Get-CMApplicationPhasedDeployment

Verwenden Sie dieses Cmdlet, um die phasenweise Bereitstellung für eine Anwendung abzurufen.

Get-CMApplicationPhasedDeployment -Name "myPhasedDeploymentName"
 
Get-CMApplicationPhasedDeployment -ApplicationName "myApplicationName"

Get-CMSoftwareUpdatePhasedDeployment

Verwenden Sie dieses Cmdlet, um die phasenweise Bereitstellung für Softwareupdates abzurufen.

Get-CMSoftwareUpdatePhasedDeployment -Name "myPhasedDeploymentName"
 
Get-CMSoftwareUpdatePhasedDeployment -SoftwareUpdateName "myUpdateName"

Get-CMTaskSequencePhasedDeployment

Verwenden Sie dieses Cmdlet, um die phasenweise Bereitstellung für eine Tasksequenz abzurufen.

Get-CMTaskSequencePhasedDeployment -Name "myPhasedDeploymentName"
 
Get-CMTaskSequencePhasedDeployment -TaskSequenceName "myTaskSequenceName"

Get-CMPhasedDeploymentStatus

Verwenden Sie dieses Cmdlet, um den Status einer bestimmten phasenweisen Bereitstellung abzurufen.

Get-CMPhasedDeploymentStatus -Name "myPhasedDeploymentName"
 
$myPhasedDeployment | Get-CMPhasedDeploymentStatus -Catalog $catalog

Move-CMPhasedDeploymentToNext

Verwenden Sie dieses Cmdlet, um die angegebene phasenweise Bereitstellung in die nächste Phase zu verschieben.

Move-CMPhasedDeploymentToNext -Name "myPhasedDeploymentName"  
 
$myPhasedDeployment | Move-CMPhasedDeploymentToNext -Force

Resume-CMPhasedDeployment

Verwenden Sie dieses Cmdlet, um die phasenweise Bereitstellung über den Anhaltestatus fortzusetzen.

Resume-CMPhasedDeployment -Name "myPhasedDeploymentName"  
 
$myPhasedDeployment | Resume-CMPhasedDeployment -Force

Suspend-CMPhasedDeployment

Verwenden Sie dieses Cmdlet, um die angegebene phasenweise Bereitstellung angehalten.

Suspend-CMPhasedDeployment -Name "myPhasedDeploymentName"
  
$myPhasedDeployment | Suspend-CMPhasedDeployment -Force

Remove-CMApplicationPhasedDeployment

Verwenden Sie dieses Cmdlet, um eine phasenweise Bereitstellung für eine Anwendung zu entfernen.

Remove-CMApplicationPhasedDeployment -ApplicationName "myApplicationName"
 
Remove-CMApplicationPhasedDeployment -Name "myPhasedDeploymentName"
 
$myPhasedDeployment | Remove-CMApplicationPhasedDeployment -Force

Remove-CMSoftwareUpdatePhasedDeployment

Verwenden Sie dieses Cmdlet, um eine phasenweise Bereitstellung für Softwareupdates zu entfernen.

Remove-CMSoftwareUpdatePhasedDeployment -SoftwareUpdateName "mySoftwareUpdateName"
 
Remove-CMSoftwareUpdatePhasedDeployment -SoftwareUpdateGroupName "mySoftwareUpdateGroupName"
 
Remove-CMSoftwareUpdatePhasedDeployment -Name "myPhasedDeploymentName"
 
$myPhasedDeployment | Remove-CMSoftwareUpdatePhasedDeployment -Force

Remove-CMTaskSequencePhasedDeployment

Verwenden Sie dieses Cmdlet, um eine phasenweise Bereitstellung für eine Tasksequenz zu entfernen.

Remove-CMTaskSequencePhasedDeployment -TaskSequenceName "myTaskSequenceName"
 
Remove-CMTaskSequencePhasedDeployment -Name "myPhasedDeploymentName"
 
$myPhasedDeployment | Remove-CMTaskSequencePhasedDeployment -Force

Add-CMPassiveSite

Verwenden Sie dieses Cmdlet, um eine passive Website hinzuzufügen.

Add-CMPassiveSite -InputObject $SiteSystem -InstallDirectory $InstallPath -SourceFilePathOption CopySourceFileFromActiveSite
Add-CMPassiveSite -SiteCode $SiteCode -SiteSystemServerName $SiteSystemServerName -InstallDirectory $InstallPath -SourceFilePathOption UseLocalSourceDirectory -LocalSourceDirectory $LocalSourcePath

Get-CMThirdPartyUpdateCategory

Verwenden Sie dieses Cmdlet, um Updatekategorien von Drittanbietern abzurufen.

Get-CMThirdPartyUpdateCategory
Get-CMThirdPartyUpdateCategory -Catalog $catalog
Get-CMThirdPartyUpdateCategory -CatalogId $catalogId -Id $categoryId
Get-CMThirdPartyUpdateCategory -CatalogName $catalogName -Name $categoryName
$catalog | Get-CMThirdPartyUpdateCategory -ParentId $parentId -PublishOption $publishOption

Move-CMContentLibrary

Verwenden Sie dieses Cmdlet, um die Inhaltsbibliothek zu verschieben, bevor Sie eine passive Website hinzufügen.

Move-CMContentLibrary -InputObject $Site -NewLocation $NewLocationPath
Move-CMContentLibrary -SiteCode $SiteCode -NewLocation $NewLocationPath

Set-CMThirdPartyUpdateCategory

Verwenden Sie dieses Cmdlet, um Updatekategorien von Drittanbietern zu ändern.

Set-CMThirdPartyUpdateCategory -Catalog $catalog -Id $categoryId -PublishOption $publishOption -EnableCategories $true
$catalog | Set-CMThirdPartyUpdateCategory -Name $categoryName -PublishOption $publishOption -EnableCategories $true
Set-CMThirdPartyUpdateCategory -CatalogId $catalogId -ParentId $parentId -PublishOption $publishOption -EnableCategories $true
Set-CMThirdPartyUpdateCategory -CatalogName $catalogName -Name $categoryName -ParentId $parentId -PublishOption $publishOption -EnableCategories $true
Set-CMThirdPartyUpdateCategory -Categories $categories -PublishOption $publishOption -EnableCategories $true

Veraltete Cmdlets

Keine

Bekannte Probleme

Keine

Cmdlet-Änderungen

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 zu Bruch gehen. Wenn Sie eines der in diesem Abschnitt aufgeführten Cmdlets oder Featurebereiche verwenden, überprüfen Sie sorgfältig die Änderungen, um zu verstehen, wie sich diese auf Ihre Verwendung auswirken können.

Add-CMDeviceCollectionQueryMembershipRule

Unterbrechungsfreie Änderungen

Weitere Fehlerbehandlung für die Abfrageregel wurde hinzugefügt.

Add-CMMsiDeploymentType

Unterbrechungsfreie Änderungen

Die folgenden neuen Parameter wurden hinzugefügt, damit Sie den Reparaturbefehl und die Verzeichnisoptionen beim Erstellen des Bereitstellungstyps konfigurieren können:

  • RepairCommand
  • RepairWorkingDirectory

Behobene Fehler

Fehlende Parameter zum Konfigurieren des Reparaturbefehls und der Verzeichnisoption beim Erstellen des Bereitstellungstyps.

Add-CMScriptDeploymentTypes

Grundlegende Änderungen

"-ContentLocation" akzeptiert keinen leeren Ordner mehr.

Behobene Fehler

"-ContentLocation" sollte keinen leeren Ordner zulassen.

Add-CMUserCollectionQueryMembershipRule

Unterbrechungsfreie Änderungen

Weitere Fehlerbehandlung für die Abfrageregel wurde hinzugefügt.

Import-CMSoftwareLicense

Unterbrechungsfreie Änderungen

Ein Parametergrenzenproblem für -Timeout wurde behoben.

New-CMApplicationDeployment

Unterbrechungsfreie Änderungen

Der folgende neue Parameter wurde hinzugefügt, damit Sie die Reparaturanwendungsoption beim Erstellen einer Bereitstellung für eine Anwendung konfigurieren können:

  • AllowRepairApp

Behobene Fehler

Fehlender Parameter zum Konfigurieren der Reparaturanwendungsoption beim Erstellen der Bereitstellung für die Anwendung.

New-CMSiteSystem

Unterbrechungsfreie Änderungen

Die Überprüfung für "-SiteSystemServerName" und "-PublicFqdn" wurde korrigiert.

Behobene Fehler

Falsche Einschränkung für die angegebenen -SiteSystemServerName und -PublicFqdn.

New-CMTSRule

Unterbrechungsfreie Änderungen

Der Variablenname "-ReferencedVariableName" akzeptiert jetzt den Variablennamen, der mit unterstrichen beginnt.

Behobene Fehler

Mit "-ReferencedVariableName" kann der Benutzer keinen Variablennamen angeben, der mit Unterstrich beginnt.

Set-CMApplicationDeployment

Unterbrechungsfreie Änderungen

Der folgende neue Parameter wurde hinzugefügt, damit Sie die Reparaturanwendungsoption konfigurieren können, wenn Sie die Bereitstellung für eine Anwendung festlegen:

  • AllowRepairApp

Behobene Fehler

Fehlender Parameter zum Konfigurieren der Reparaturanwendungsoption beim Festlegen der Bereitstellung für die Anwendung.

Set-CMMsiDeploymentType

Unterbrechungsfreie Änderungen

Die folgenden neuen Parameter wurden hinzugefügt, um die Konfiguration von Reparaturbefehlen und Verzeichnisoptionen beim Festlegen des Bereitstellungstyps zu ermöglichen:

  • RepairCommand
  • RepairWorkingDirectory

Behobene Fehler

Fehlende Parameter zum Konfigurieren des Reparaturbefehls und der Verzeichnisoption beim Festlegen des Bereitstellungstyps.

Set-CMSite

Unterbrechungsfreie Änderungen

Der folgende neue Parameter wurde hinzugefügt, damit Sie die Installation für eine fehlgeschlagene passive Website wiederholen können:

  • RetryInstallPassiveSite

Der folgende neue Parameter wurde hinzugefügt, um es Ihnen zu ermöglichen, eine passive Website zum aktiven zu höherstufen:

  • PromotePassiveSiteToActive

Set-CMScriptDeploymentType

Grundlegende Änderungen

"-ContentLocation" akzeptiert keinen leeren Ordner mehr.

Behobene Fehler

"-ContentLocation" sollte keinen leeren Ordner zulassen.

Set-CMThirdPartyUpdateCatalog

Unterbrechungsfreie Änderungen

  • Das Cmdlet unterstützt jetzt das Festlegen von "Synchronisierungszeitplan" für einen Katalog.
  • Ein interner Funktionsaufruf wurde aufgrund einer systemeigenen Methodenänderung geändert.
Beispiel
Set-CMThirdPartyUpdateCatalog -Name $name –Schedule $schedule