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

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

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 instance oder eine stufenweise Bereitstellung abzurufen.

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

New-CMApplicationAutoPhasedDeployment

Verwenden Sie dieses Cmdlet, um eine mehrstufige Bereitstellung für eine Anwendung zu erstellen, indem Sie zwei Phasen mit den gleichen 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 stufenweise Bereitstellung für Softwareupdates zu erstellen, indem Sie zwei Phasen mit den gleichen 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 stufenweise Bereitstellung für Softwareupdates zu erstellen. Sie müssen zunächst 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 stufenweise Bereitstellung für eine Tasksequenz zu erstellen, indem Sie zwei Phasen mit den gleichen 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 stufenweise Bereitstellung für eine Tasksequenz zu erstellen. Sie müssen zunächst 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 stufenweise Bereitstellung für eine Anwendung abzurufen.

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

Get-CMSoftwareUpdatePhasedDeployment

Verwenden Sie dieses Cmdlet, um die stufenweise Bereitstellung von Softwareupdates abzurufen.

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

Get-CMTaskSequencePhasedDeployment

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

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

Get-CMPhasedDeploymentStatus

Verwenden Sie dieses Cmdlet, um die status einer bestimmten mehrstufigen Bereitstellung abzurufen.

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

Move-CMPhasedDeploymentToNext

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

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

Resume-CMPhasedDeployment

Verwenden Sie dieses Cmdlet, um die stufenweise Bereitstellung ab dem anhaltenden status fortzusetzen.

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

Suspend-CMPhasedDeployment

Verwenden Sie dieses Cmdlet, um die angegebene bereitstellung in Phasen anzusetzen.

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

Remove-CMApplicationPhasedDeployment

Verwenden Sie dieses Cmdlet, um eine stufenweise 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 mehrstufige 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 stufenweise 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 einen passiven Standort 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 nicht geändert 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.

Add-CMDeviceCollectionQueryMembershipRule

Unterbrechungsfreie Änderungen

Weitere Fehlerbehandlung für die Abfrageregel 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

Breaking Changes

-ContentLocation akzeptiert keinen leeren Ordner mehr.

Behobene Fehler

-ContentLocation darf keinen leeren Ordner zulassen.

Add-CMUserCollectionQueryMembershipRule

Unterbrechungsfreie Änderungen

Weitere Fehlerbehandlung für die Abfrageregel hinzugefügt.

Import-CMSoftwareLicense

Unterbrechungsfreie Änderungen

Ein Parameterbegrenzungsproblem für -Timeout wurde behoben.

New-CMApplicationDeployment

Unterbrechungsfreie Änderungen

Der folgende neue Parameter wurde hinzugefügt, damit Sie die Option "Anwendung reparieren" 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

-ReferencedVariableName akzeptiert jetzt den Variablennamen, der mit einem Unterstrich beginnt.

Behobene Fehler

-ReferencedVariableName ermöglicht es dem Benutzer nicht, variablen Namen anzugeben, der mit einem Unterstrich beginnt.

Set-CMApplicationDeployment

Unterbrechungsfreie Änderungen

Der folgende neue Parameter wurde hinzugefügt, mit dem Sie die Option "Anwendung reparieren" konfigurieren können, wenn Sie die Bereitstellung für eine Anwendung festlegen:

• AllowRepairApp

Behobene Fehler

Fehlender Parameter zum Konfigurieren der Option "Anwendung reparieren", wenn die Bereitstellung für die Anwendung festgelegt wird.

Set-CMMsiDeploymentType

Unterbrechungsfreie Änderungen

Die folgenden neuen Parameter wurden hinzugefügt, mit denen Sie reparaturbefehls- und verzeichnisoptionen konfigurieren können, wenn Sie den Bereitstellungstyp festlegen:

• 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 einen fehlerhaften passiven Standort wiederholen können:

• RetryInstallPassiveSite

Der folgende neue Parameter wurde hinzugefügt, damit Sie eine passive Website auf aktiv heraufstufen können:

• PromotePassiveSiteToActive

Set-CMScriptDeploymentType

Breaking Changes

-ContentLocation akzeptiert keinen leeren Ordner mehr.

Behobene Fehler

-ContentLocation darf keinen leeren Ordner zulassen.

Set-CMThirdPartyUpdateCatalog

Unterbrechungsfreie Änderungen

• Das Cmdlet unterstützt jetzt das Festlegen des Synchronisierungszeitplans für einen Katalog.
• Ein interner Funktionsaufruf wurde aufgrund einer nativen Methodenänderung geändert.

Beispiel

Set-CMThirdPartyUpdateCatalog -Name $name –Schedule $schedule