Modifiche alla libreria di cmdlet di Gestione configurazione per la versione 2002

Si applica a: Gestione configurazione (Current Branch)

Modifiche importanti

Nuovi cmdlet

New-CMSoftwareUpdatePhase

Usare questo cmdlet per creare una fase di distribuzione per l'aggiornamento software.

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

New-CMTaskSequencePhase

Usare questo cmdlet per creare una fase di distribuzione per una sequenza di attività.

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

Get-CMPhase

Usare questo cmdlet per ottenere la fase di distribuzione per un'istanza specifica o una distribuzione in più fasi.

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

New-CMApplicationAutoPhasedDeployment

Usare questo cmdlet per creare una distribuzione in più fasi per un'applicazione generando due fasi con le stesse impostazioni.

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

Usare questo cmdlet per creare una distribuzione in più fasi per gli aggiornamenti software generando due fasi con le stesse impostazioni.

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

Usare questo cmdlet per creare una distribuzione in più fasi per gli aggiornamenti software. È necessario aggiungere prima nuove fasi di distribuzione personalizzate con il cmdlet New-CMSoftwareUpdatePhase.

$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

Usare questo cmdlet per creare una distribuzione in più fasi per una sequenza di attività generando due fasi con le stesse impostazioni.

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

Usare questo cmdlet per creare una distribuzione in più fasi per una sequenza di attività. È necessario aggiungere prima nuove fasi di distribuzione personalizzate con il cmdlet New-CMTaskSequencePhase.

$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

Usare questo cmdlet per ottenere la distribuzione in più fasi per un'applicazione.

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

Get-CMSoftwareUpdatePhasedDeployment

Usare questo cmdlet per ottenere la distribuzione in più fasi per gli aggiornamenti software.

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

Get-CMTaskSequencePhasedDeployment

Usare questo cmdlet per ottenere la distribuzione in più fasi per una sequenza di attività.

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

Get-CMPhasedDeploymentStatus

Usare questo cmdlet per ottenere lo stato di una specifica distribuzione in più fasi.

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

Move-CMPhasedDeploymentToNext

Usare questo cmdlet per spostare la distribuzione in più fasi specificata alla fase successiva.

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

Resume-CMPhasedDeployment

Usare questo cmdlet per riprendere la distribuzione in più fasi dallo stato di sospensione.

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

Suspend-CMPhasedDeployment

Usare questo cmdlet per sospendere la distribuzione in più fasi specificata.

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

Remove-CMApplicationPhasedDeployment

Usare questo cmdlet per rimuovere una distribuzione in più fasi per un'applicazione.

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

Remove-CMSoftwareUpdatePhasedDeployment

Usare questo cmdlet per rimuovere una distribuzione in più fasi per gli aggiornamenti software.

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

Remove-CMTaskSequencePhasedDeployment

Usare questo cmdlet per rimuovere una distribuzione in più fasi per una sequenza di attività.

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

Add-CMPassiveSite

Usare questo cmdlet per aggiungere un sito passivo.

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

Get-CMThirdPartyUpdateCategory

Usare questo cmdlet per ottenere le categorie di aggiornamento di terze parti.

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

Usare questo cmdlet per spostare la raccolta contenuto prima di aggiungere un sito passivo.

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

Set-CMThirdPartyUpdateCategory

Usare questo cmdlet per modificare le categorie di aggiornamento di terze parti.

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

Cmdlet deprecati

Nessuno

Problemi noti

Nessuno

Modifiche dei cmdlet

In questa versione sono state apportate le modifiche seguenti ai cmdlet esistenti. Le modifiche possono essere nuove funzionalità, correzioni di bug o deprecazioni. Alcuni cambiamenti potrebbero interrompersi. Se si usa uno dei cmdlet o delle aree di funzionalità elencati in questa sezione, esaminare attentamente le modifiche per comprendere in che modo potrebbero influire sull'uso.

Add-CMDeviceCollectionQueryMembershipRule

Modifiche non significative

È stata aggiunta una maggiore gestione degli errori per la regola di query.

Add-CMMsiDeploymentType

Modifiche non significative

Sono stati aggiunti i nuovi parametri seguenti per consentire di configurare le opzioni di comando e directory di ripristino durante la creazione del tipo di distribuzione:

• RepairCommand
• RepairWorkingDirectory

Bug che sono stati risolti

Parametri mancanti per configurare il comando di riparazione e l'opzione della directory durante la creazione del tipo di distribuzione.

Add-CMScriptDeploymentTypes

Modifiche di rilievo

-ContentLocation non accetterà più una cartella vuota.

Bug che sono stati risolti

-ContentLocation non deve consentire una cartella vuota.

Add-CMUserCollectionQueryMembershipRule

Modifiche non significative

È stata aggiunta una maggiore gestione degli errori per la regola di query.

Import-CMSoftwareLicense

Modifiche non significative

È stato risolto un problema di limitazione dei parametri per -Timeout.

New-CMApplicationDeployment

Modifiche non significative

È stato aggiunto il nuovo parametro seguente per consentire di configurare l'opzione di ripristino dell'applicazione durante la creazione di una distribuzione per un'applicazione:

• AllowRepairApp

Bug che sono stati risolti

Parametro mancante per configurare l'opzione di ripristino dell'applicazione durante la creazione della distribuzione per l'applicazione.

New-CMSiteSystem

Modifiche non significative

È stata corretta la convalida per -SiteSystemServerName e -PublicFqdn.

Bug che sono stati risolti

Limitazione errata per gli elementi -SiteSystemServerName e -PublicFqdn specificati.

New-CMTSRule

Modifiche non significative

Il nome della variabile -ReferencedVariableName ora accetta il nome della variabile che inizia con il carattere di sottolineatura.

Bug che sono stati risolti

-ReferencedVariableName non consente all'utente di specificare il nome della variabile che inizia con il carattere di sottolineatura.

Set-CMApplicationDeployment

Modifiche non significative

È stato aggiunto il nuovo parametro seguente per consentire di configurare l'opzione di ripristino dell'applicazione quando si imposta la distribuzione per un'applicazione:

• AllowRepairApp

Bug che sono stati risolti

Parametro mancante per configurare l'opzione di ripristino dell'applicazione quando viene impostata la distribuzione per l'applicazione.

Set-CMMsiDeploymentType

Modifiche non significative

Sono stati aggiunti i nuovi parametri seguenti per consentire di configurare le opzioni di comando e directory di ripristino quando si imposta il tipo di distribuzione:

• RepairCommand
• RepairWorkingDirectory

Bug che sono stati risolti

Parametri mancanti per configurare il comando di riparazione e l'opzione della directory quando viene impostato il tipo di distribuzione.

Set-CMSite

Modifiche non significative

È stato aggiunto il nuovo parametro seguente per consentire di riprovare l'installazione per un sito passivo non riuscito:

• RetryInstallPassiveSite

È stato aggiunto il nuovo parametro seguente per consentire di promuovere un sito passivo ad attivo:

• Alzare di livelloPassiveSiteToActive

Set-CMScriptDeploymentType

Modifiche di rilievo

-ContentLocation non accetterà più una cartella vuota.

Bug che sono stati risolti

-ContentLocation non deve consentire una cartella vuota.

Set-CMThirdPartyUpdateCatalog

Modifiche non significative

• Il cmdlet supporta ora l'impostazione di "Pianificazione sincronizzazione" per un catalogo.
• È stata modificata una chiamata di funzione interna a causa di una modifica del metodo nativo.

Esempio

Set-CMThirdPartyUpdateCatalog -Name $name –Schedule $schedule