Compartilhar via

Configuration Manager da Biblioteca de Cmdlets da versão 2002

  • Artigo

Aplica-se a: Gerenciador de Configurações (branch atual)

Observação

Configuration Manager branch atual versão 1910 é a linha de base para essas alterações. Para obter mais informações, consulte Configuration Manager da Biblioteca de Cmdlets para a versão 1910.

Alterações importantes

Novos cmdlets

New-CMSoftwareUpdatePhase

Use este cmdlet para criar uma fase de implantação para atualização de software.

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

New-CMTaskSequencePhase

Use este cmdlet para criar uma fase de implantação para uma sequência de tarefas.

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

Get-CMPhase

Use esse cmdlet para obter a fase de implantação para uma instância específica ou uma implantação em fases.

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

New-CMApplicationAutoPhasedDeployment

Use esse cmdlet para criar uma implantação em fases para um aplicativo gerando duas fases com as mesmas configurações.

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

Use esse cmdlet para criar uma implantação em fases para atualizações de software gerando duas fases com as mesmas configurações.

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

Use este cmdlet para criar uma implantação em fases para atualizações de software. Você precisará adicionar novas fases de implantação personalizadas com o cmdlet New-CMSoftwareUpdatePhase primeiro.

$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

Use esse cmdlet para criar uma implantação em fases para uma sequência de tarefas gerando duas fases com as mesmas configurações.

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

Use esse cmdlet para criar uma implantação em fases para uma sequência de tarefas. Você precisará adicionar novas fases de implantação personalizadas com o cmdlet New-CMTaskSequencePhase primeiro.

$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

Use esse cmdlet para obter a implantação em fases de um aplicativo.

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

Get-CMSoftwareUpdatePhasedDeployment

Use esse cmdlet para obter a implantação em fases para atualizações de software.

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

Get-CMTaskSequencePhasedDeployment

Use esse cmdlet para obter a implantação em fases de uma sequência de tarefas.

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

Get-CMPhasedDeploymentStatus

Use este cmdlet para obter o status de uma implantação em fases específica.

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

Move-CMPhasedDeploymentToNext

Use esse cmdlet para mover a implantação em fases especificada para a próxima fase.

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

Resume-CMPhasedDeployment

Use esse cmdlet para retomar a implantação em fases do status de suspensão.

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

Suspend-CMPhasedDeployment

Use este cmdlet para suspender a implantação em fases especificada.

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

Remove-CMApplicationPhasedDeployment

Use este cmdlet para remover uma implantação em fases de um aplicativo.

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

Remove-CMSoftwareUpdatePhasedDeployment

Use este cmdlet para remover uma implantação em fases para atualizações de software.

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

Remove-CMTaskSequencePhasedDeployment

Use este cmdlet para remover uma implantação em fases de uma sequência de tarefas.

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

Add-CMPassiveSite

Use este cmdlet para adicionar um site passivo.

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

Get-CMThirdPartyUpdateCategory

Use este cmdlet para obter categorias de atualização de terceiros.

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

Use este cmdlet para mover a biblioteca de conteúdo antes de adicionar um site passivo.

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

Set-CMThirdPartyUpdateCategory

Use este cmdlet para modificar categorias de atualização de terceiros.

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

Cmdlets preteridos

Nenhum

Problemas conhecidos

Nenhum

Alterações de cmdlet

As alterações a seguir foram feitas nos cmdlets existentes nesta versão. As alterações podem ser novas funcionalidades, correções de bugs ou substituição. Algumas alterações podem estar falhando. Se você usar um dos cmdlets ou áreas de recursos listadas nesta seção, examine cuidadosamente as alterações para entender como elas podem afetar seu uso.

Add-CMDeviceCollectionQueryMembershipRule

Alterações sem interrupção

Adição de mais tratamento de erros para a regra de consulta.

Add-CMMsiDeploymentType

Alterações sem interrupção

Adicionados os seguintes novos parâmetros para permitir que você configure as opções de comando e diretório de reparo ao criar o tipo de implantação:

  • RepairCommand
  • RepairWorkingDirectory

Bugs que foram corrigidos

Parâmetros ausentes para configurar a opção de comando e diretório de reparo ao criar o tipo de implantação.

Add-CMScriptDeploymentTypes

Alterações interruptivas

O -ContentLocation não aceitará mais uma pasta vazia.

Bugs que foram corrigidos

O -ContentLocation não deve permitir uma pasta vazia.

Add-CMUserCollectionQueryMembershipRule

Alterações sem interrupção

Adição de mais tratamento de erros para a regra de consulta.

Import-CMSoftwareLicense

Alterações sem interrupção

Correção de um problema delimitador de parâmetro para -Timeout.

New-CMApplicationDeployment

Alterações sem interrupção

Adicionado o novo parâmetro a seguir para permitir que você configure a opção de aplicativo de reparo ao criar uma implantação para um aplicativo:

  • AllowRepairApp

Bugs que foram corrigidos

Parâmetro ausente para configurar a opção reparar o aplicativo ao criar a implantação para o aplicativo.

New-CMSiteSystem

Alterações sem interrupção

Corrigida a validação para -SiteSystemServerName e -PublicFqdn.

Bugs que foram corrigidos

Limitação incorreta para o -SiteSystemServerName e -PublicFqdn especificados.

New-CMTSRule

Alterações sem interrupção

O -ReferencedVariableName agora aceita o nome da variável que começa com sublinhado.

Bugs que foram corrigidos

O -ReferencedVariableName não permite que o usuário especifique o nome da variável que começa com sublinhado.

Set-CMApplicationDeployment

Alterações sem interrupção

Adicionado o novo parâmetro a seguir para permitir que você configure a opção de aplicativo de reparo ao definir a implantação de um aplicativo:

  • AllowRepairApp

Bugs que foram corrigidos

Parâmetro ausente para configurar a opção reparar aplicativo ao definir a implantação para o aplicativo.

Set-CMMsiDeploymentType

Alterações sem interrupção

Adicionados os seguintes novos parâmetros para permitir que você configure opções de comando e diretório de reparo ao definir o tipo de implantação:

  • RepairCommand
  • RepairWorkingDirectory

Bugs que foram corrigidos

Parâmetros ausentes para configurar o comando de reparo e a opção de diretório ao definir o tipo de implantação.

Set-CMSite

Alterações sem interrupção

Adicionado o novo parâmetro a seguir para permitir que você repita a instalação de um site passivo com falha:

  • RetryInstallPassiveSite

Adicionado o novo parâmetro a seguir para permitir que você promova um site passivo para ativo:

  • PromotePassiveSiteToActive

Set-CMScriptDeploymentType

Alterações interruptivas

O -ContentLocation não aceitará mais uma pasta vazia.

Bugs que foram corrigidos

O -ContentLocation não deve permitir uma pasta vazia.

Set-CMThirdPartyUpdateCatalog

Alterações sem interrupção

  • O cmdlet agora dá suporte à configuração de 'Agenda de Sincronização' para um catálogo.
  • Modificou uma chamada de função interna devido a uma alteração de método nativo.
Exemplo
Set-CMThirdPartyUpdateCatalog -Name $name –Schedule $schedule