Alterações da biblioteca de cmdlets do Configuration Manager, versão 2010

  • Artigo

Aplica-se a: Configuration Manager (branch atual)

Estas notas de versão resumem as alterações na biblioteca de cmdlets Configuration Manager na versão 2010.

A partir da versão 2010, o Configuration Manager biblioteca de cmdlets do PowerShell agora oferece suporte para o PowerShell 7. Para obter mais informações, consulte suporte para o PowerShell versão 7.

Observação

Configuration Manager Branch atual versão 2002 é a linha de base para essas alterações. Para obter mais informações, consulte Configuration Manager as alterações da biblioteca de cmdlets para a versão 2006.

Gateway de gerenciamento de nuvem

Com mais clientes Gerenciando dispositivos remotos agora, esta versão inclui vários cmdlets novos e aprimorados do Windows PowerShell para o CMG (gateway de gerenciamento de nuvem). Você pode usar os cmdlets para automatizar a criação, a configuração e o gerenciamento dos requisitos de serviço do CMG e do Azure AD (Azure Active Directory).

Observação

Embora alguns dos novos cmdlets possam funcionar com outros serviços do Azure, só serão testados com a conexão de Gerenciamento de Nuvem para dar suporte ao CMG.

Por exemplo, um administrador do Azure primeiro cria os dois aplicativos necessários no Azure AD. Em seguida, você escreve um script que usa os seguintes cmdlets para implantar um CMG:

  1. Import-CMAADServerApplication: crie a definição de aplicativo do servidor do Azure AD no Configuration Manager.
  2. Import-CMAADClientApplication: crie a definição de aplicativo do cliente Azure AD no Configuration Manager.
  3. Use Get-CMAADApplication para obter os objetos do aplicativo e transmita para New-CMCloudManagementAzureService para criar a conexão de serviço do Azure no Configuration Manager.
  4. New-CMCloudManagementGateway: crie o serviço CMG no Azure.
  5. Add-CMCloudManagementGatewayConnectionPoint: crie o sistema de sites do ponto de conexão do CMG.

Novos cmdlets para CMG

Cmdlets atualizados para CMG

Os seguintes cmdlets existentes têm melhorias significativas. Para obter mais informações, consulte as seguintes notas de versão:

Cmdlets existentes para CMG

Você pode continuar a usar os seguintes cmdlets existentes do CMG:

Novos cmdlets

Gerenciamento de aplicativos

Gerenciamento de coleta

Upgrade de edição do Windows 10

Perfis do navegador Microsoft Edge

Perfis do OneDrive for Business

Cmdlets preteridos e removidos

Os cmdlets a seguir para Configuration Manager ambientes híbridos não estão mais disponíveis:

  • Add-CMAndroidDeploymentType
  • Add-CMGooglePlayDeploymentType
  • Add-CMIosAppStoreDeploymentType
  • Add-CMIosDeploymentType
  • Set-CMAndroidDeploymentType
  • Set-CMGooglePlayDeploymentType
  • Set-CMIosAppStoreDeploymentType
  • Set-CMIosDeploymentType

Para obter mais informações, consulte o que aconteceu com o MDM híbrido?

O seguinte cmdlet foi preterido:

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 reprovação. Algumas alterações podem estar sendo interrompidas. Se você usar um dos cmdlets ou áreas de recursos listados nesta seção, examine atentamente as alterações para entender como elas podem afetar o seu uso.

Add-CMComplianceSettingRegistryKeyValue

Para obter mais informações, consulte Add-CMComplianceSettingRegistryKeyValue.

Alterações sem interrupção

O parâmetro ExpectedValue pode aceitar um valor vazio.

Add-CMDistributionPoint

Para saber mais, confira Add-CMDistributionPoint.

Bugs corrigidos

Corrigido um problema para a criação do ponto de distribuição.

Add-CMDeviceCollectionDirectMembershipRule

Para obter mais informações, consulte Add-CMDeviceCollectionDirectMembershipRule.

Bugs corrigidos

Corrigido um problema de verificação de número de dispositivo duplicado.

Add-CMManagementPoint

Para obter mais informações, consulte Add-CMManagementPoint.

Bugs corrigidos

Corrigido um problema para o suporte ao gateway de gerenciamento de nuvem.

Add-CMPassiveSite

Para obter mais informações, consulte Add-CMPassiveSite.

Bugs corrigidos

Corrigido um problema para o site passivo na hierarquia.

Add-CMTaskSequenceStep

Para obter mais informações, consulte Add-CMTaskSequenceStep.

Bugs corrigidos

Corrigido um problema de tamanho de política ao usar várias etapas do PowerShell que contêm scripts grandes.

Add-CMWindowsAppxDeploymentType

Para obter mais informações, consulte Add-CMWindowsAppxDeploymentType.

Alterações sem interrupção

Adicionada a função para dar suporte a MSIX.

Approve-CMDevice

Para obter mais informações, consulte Approve-CMDevice.

Alterações sem interrupção

Corrigido um problema ao trabalhar com Get-CMDevice.

Enable-CMSiteFeature

Para obter mais informações, consulte Enable-CMSiteFeature.

Alterações sem interrupção

Novos sinalizadores adicionados para dar suporte a recursos de nuvem.

Get-CMScript

Para obter mais informações, consulte Get-CMScript.

Alterações sem interrupção

Adição do novo parâmetro ScriptGuid para dar suporte à consulta por GUID de script.

Get-CMSiteFeature

Para obter mais informações, consulte Get-CMSiteFeature.

Alterações sem interrupção

Novos sinalizadores adicionados para dar suporte a recursos de nuvem.

Get-CMSoftwareUpdate

Para obter mais informações, consulte Get-CMSoftwareUpdate.

Alterações sem interrupção

Novo fornecedor de parâmetros adicionado para especificar a origem da atualização de software.

Exemplo:

Get-CMSoftwareUpdate -Name $Update -Vendor "Microsoft"

Get-CMStatusMessageQuery

Para obter mais informações, consulte Get-CMStatusMessageQuery.

Bugs corrigidos

Corrigido um problema para o parâmetro exmessage.

Import-CMDriver

Para obter mais informações, consulte Import-CMDriver.

Alterações sem interrupção

Adição do novo parâmetro AdministrativeCategoryName para especificar um nome para a categoria de driver.

Exemplo:

Import-CMDriver -UncFileLocation $DriverFolder -ImportFolder -ImportDuplicateDriverOption AppendCategory -AdministrativeCategory "Video drivers"

Invoke-CMAnalyzePackage

Para obter mais informações, consulte Invoke-CMAnalyzePackage.

Alterações interruptivas

Parâmetro de pacote removido. Redirecione o objeto de pacote ou use o parâmetro InputObject .

Alterações sem interrupção

Adicionado suporte de pipeline e o parâmetro InputObject .

Exemplo:

$pkg | Invoke-CMAnalyzePackage

Invoke-CMClientAction

Para obter mais informações, consulte Invoke-CMClientAction.

Bugs corrigidos

Problema de pipeline corrigido para a coleção de parâmetros.

Exemplo:

Get-CMCollection -Name "deviceCol1" | Invoke-CMClientAction -ActionType ClientNotificationRequestUsersPolicyNow

Invoke-CMConvertPackage

Para obter mais informações, consulte Invoke-CMConvertPackage.

Alterações interruptivas

Parâmetro de pacote removido. Redirecione o objeto de pacote ou use o parâmetro InputObject .

Alterações sem interrupção

Adicionado suporte de pipeline e o parâmetro InputObject .

Exemplo:

$pkg | Invoke-CMConvertPackage

Invoke-CMReport

Para obter mais informações, consulte Invoke-CMReport.

Bugs corrigidos

Corrigido um problema para o caminho do parâmetro.

Invoke-CMScript

Para obter mais informações, consulte Invoke-CMScript.

Alterações sem interrupção

Adicione o parâmetro ScriptParameter para passar parâmetros para o script de destino.

Exemplo:

$Hash = @{"FolderName"="c:\test\test1"; "FileName"="test2"}

Invoke-CMScript -ScriptGuid $scriptGuid -Device (Get-CMDevice -Name $targetPCName) -ScriptParameter $Hash

New-CMBMSClientConfigureCheckIntervalPolicy

Para obter mais informações, consulte New-CMBMSClientConfigureCheckIntervalPolicy.

Bugs corrigidos

Corrigido um problema ao criar uma nova instância de configuração de política.

New-CMBoundary

Para obter mais informações, consulte New-CMBoundary.

Alterações sem interrupção

Opção de VPN adicionada no parâmetro de Limitetype.

New-CMBootableMedia

Para obter mais informações, consulte New-CMBootableMedia.

Alterações sem interrupção

Adicione o parâmetro SiteCode.

New-CMCloudManagementGateway

Para obter mais informações, confira New-CMCloudManagementGateway.

Alterações sem interrupção

Os seguintes parâmetros são novos:

  • CARootCert
  • EnableCloudDPFunction
  • EnableStorageQuota
  • EnableTrafficOut
  • EnforceProtocol
  • Force
  • GroupName
  • IsUsingExistingGroup
  • ServerAppClientID
  • ServiceCertPassword
  • ServiceCertPath
  • ServiceName
  • StorageCriticalPct
  • StorageQuotaGB
  • StorageWarningPct
  • TrafficOutStopService

Os seguintes parâmetros são atualizados:

  • CheckClientCertRevocation
  • EnvironmentSetting
  • Região
  • SubscriptionId
  • TrafficCriticalPct
  • TrafficWarningPct

Alterações interruptivas

Os seguintes parâmetros são removidos deste cmdlet:

  • GovernmentSubscription
  • ManagementCertificatePassword
  • ManagementCertificatePath
  • PassThru
  • RootCertificatePath
  • ServiceCertificatePassword
  • ServiceCertificatePath
  • Não CName

New-CMCoManagementPolicy

Para obter mais informações, consulte New-CMCoManagementPolicy.

Alterações sem interrupção

Adição de aplicabilidade de várias sessões

ARM64 aplicabilidade adicionada

New-CMComplianceRuleFileFolderDate

Para obter mais informações, consulte New-CMComplianceRuleFileFolderDate.

Alterações sem interrupção

Ajuste a lógica do cmdlet para processar os valores da modificação e da criação de parâmetros para alinhar com outros cmdlets.

New-CMComplianceRuleFileFolderSimple

Para obter mais informações, consulte New-CMComplianceRuleFileFolderSimple.

Alterações interruptivas

Alterado o tipo do parâmetro PropertyType de filefolderproperty para o tipo SimpleFileFolderProperty .

New-CMDetectionClauseDirectory

Para obter mais informações, consulte New-CMDetectionClauseDirectory.

Alterações interruptivas

Alterado o tipo do parâmetro ExpressionOperator de RuleExpressionOperator para o tipo FileFolderRuleExpressionOperator .

New-CMDetectionClauseFile

Para obter mais informações, consulte New-CMDetectionClauseFile.

Alterações interruptivas

Alterado o tipo do parâmetro ExpressionOperator de RuleExpressionOperator para o tipo FileFolderRuleExpressionOperator .

New-CMDetectionClauseMacBundle

Para obter mais informações, consulte New-CMDetectionClauseMacBundle.

Alterações interruptivas

Alterado o tipo do parâmetro ExpressionOperator de RuleExpressionOperator para o tipo MacRuleExpressionOperator .

Bugs corrigidos

Corrigido um problema para o parâmetro PropertyType.

New-CMDetectionClauseMacPackage

Para obter mais informações, consulte New-CMDetectionClauseMacPackage.

Alterações interruptivas

Alterado o tipo do parâmetro ExpressionOperator de RuleExpressionOperator para o tipo MacRuleExpressionOperator .

New-CMDetectionClauseRegistryKeyValue

Para obter mais informações, consulte New-CMDetectionClauseRegistryKeyValue.

Alterações interruptivas

Alterado o tipo do parâmetro ExpressionOperator de RuleExpressionOperator para o tipo RegistryValueRuleExpressionOperator .

New-CMDetectionClauseWindowsInstaller

Para obter mais informações, consulte New-CMDetectionClauseWindowsInstaller.

Alterações interruptivas

Alterado o tipo do parâmetro ExpressionOperator de RuleExpressionOperator para o tipo WindowsInstallerRuleExpressionOperator .

New-CMDriverPackage

Para obter mais informações, consulte New-CMDriverPackage.

Bugs corrigidos

Corrigido um problema para o parâmetro DriverModel.

New-CM * PhasedDeployment

Para obter mais informações, consulte os seguintes artigos:

Bugs corrigidos

Corrigido um problema para o parâmetro WhatIf.

Alterações sem interrupção

Validação adicionada para nome de fase duplicada.

New-CMPrestageMedia

Para obter mais informações, consulte New-CMPrestageMedia.

Alterações sem interrupção

Adicione o parâmetro SiteCode.

New-CMProgram

Para obter mais informações, consulte New-CMProgram.

Alterações interruptivas

Renomeou o tipo RenameWithUnc para RunWithUnc para o parâmetro drivemode.

New-CMSoftwareUpdateDeployment

Para obter mais informações, consulte New-CMSoftwareUpdateDeployment.

Alterações sem interrupção

Adição do novo parâmetro DeployWithNoPackage para atualização de software não baixada.

New-CMStandaloneMedia

Para obter mais informações, consulte New-CMStandaloneMedia.

Bugs corrigidos

Correção de um problema para o parâmetro PrestartPackage

New-CMTaskSequence

Para obter mais informações, consulte New-CMTaskSequence.

Bugs corrigidos

Corrigido um problema de tamanho de política quando você usa várias etapas do PowerShell que contêm scripts grandes.

New-CMTaskSequenceDeployment

Para obter mais informações, consulte New-CMTaskSequenceDeployment.

Bugs corrigidos

Corrigido um problema para o parâmetro AllowFallback.

Alterações sem interrupção

Validação adicionada para o agendamento de parâmetro para evitar valor duplicado com atribuição existente.

New-CMTaskSequenceMedia

Para obter mais informações, consulte New-CMTaskSequenceMedia.

Alterações sem interrupção

Tempo limite alterado na criação de mídia de um dia para três dias.

New-CMTSPartitionSetting

Para obter mais informações, consulte New-CMTSPartitionSetting.

Bugs corrigidos

Corrigido um problema para o parâmetro EnableQuickFormat.

New-CMTSStepEnableBitLocker

Para obter mais informações, consulte New-CMTSStepEnableBitLocker.

Bugs corrigidos

Correção de um problema para o método de criptografia especificado pelo usuário.

New-CMTSStepOfflineEnableBitLocker

Para obter mais informações, consulte New-CMTSStepOfflineEnableBitLocker.

Bugs corrigidos

Correção de um problema para o método de criptografia especificado pelo usuário.

New-CMTSStepPreStartCheck

Para obter mais informações, consulte New-CMTSStepPreStartCheck.

Bugs corrigidos

Corrigido um problema para a nova etapa de preparação de cheque.

Corrigido um problema para o parâmetro OSLanguageId.

Alterações sem interrupção

Adicione um novo parâmetro para verificação de UEFI, CheckUefi.

Remove-CMTaskSequenceGroup

Para obter mais informações, consulte Remove-CMTaskSequenceGroup.

Bugs corrigidos

Corrigido um problema de tamanho de política quando você usa várias etapas do PowerShell que contêm scripts grandes.

Set-CM * PhasedDeployment

Para obter mais informações, consulte os seguintes artigos:

Bugs corrigidos

Corrigido um problema para o parâmetro WhatIf.

Set-CMBoundary

Para obter mais informações, consulte set-CMBoundary.

Alterações sem interrupção

VPNOpção adicionada em delimitador.

Set-CMClientSettingComputerRestart

Para obter mais informações, consulte set-CMClientSettingComputerRestart.

Alterações sem interrupção

Um novo parâmetro NoRebootEnforcement foi adicionado.

Set-CMClientSettingSoftwareUpdate

Para obter mais informações, consulte set-CMClientSettingSoftwareUpdate.

Alterações sem interrupção

Parâmetros adicionados:

  • EnableInstallation
  • ThreadPriority
  • EnableDynamicUpdate

Exemplo:

Set-CMClientSettingSoftwareUpdate -InputObject $testsetting -Enable $true -ScanSchedule $Sch1 -DeploymentEvaluationSchedule $Sch2 -BatchingTimeout 3 -TimeUnit Days -EnforceMandatory $true -Office365ManagementType $false -EnableThirdPartyUpdates $true -EnableDeltaDownload $true -EnableInstallation $true -ThreadPriority Normal -EnableDynamicUpdate $true

Set-CMCloudManagementGateway

Para obter mais informações, consulte set-CMCloudManagementGateway.

Alterações sem interrupção

Os seguintes parâmetros são novos:

  • CARootCert
  • EnableCloudDPFunction
  • EnableStorageQuota
  • EnableTrafficOut
  • EnforceProtocol
  • RemoveCertThumbprints
  • StorageCriticalPct
  • StorageQuotaGB
  • StorageWarningPct
  • TrafficOutStopService
  • VMInstanceCount

Alterações interruptivas

Os seguintes parâmetros são removidos deste cmdlet:

  • VMInstancesCount

Set-CMDiscoveryMethod

Para obter mais informações, consulte set-CMDiscoveryMethod.

Bugs corrigidos

Corrigido um problema para o parâmetro AddGroupDiscoveryScope.

Set-CMDistributionPoint

Para obter mais informações, confira Set-CMDistributionPoint.

Alterações sem interrupção

Parâmetros adicionados para dar suporte ao cache conectado da Microsoft:

  • EnableDoinc
  • DiskSpaceUnit
  • DiskSpaceDoinc
  • LocalDriveDoinc
  • RetainDoincCache
  • AgreeDoincLicense

Exemplo:

$dp | Set-CMDistributionPoint -EnableDoinc $true -AgreeDoincLicense $true

$dp | Set-CMDistributionPoint -RetainDoincCache $true -EnableDoinc $true -AgreeDoincLicense $true

$dp | Set-CMDistributionPoint -LocalDriveDoinc "Z:" -DiskSpaceDoinc 9000 -DiskSpaceUnit GB

Set-CMDriverPackage

Para obter mais informações, consulte set-CMDriverPackage.

Bugs corrigidos

Corrigido um problema para o parâmetro DriverModel.

Set-CMManagementPoint

Para obter mais informações, consulte set-CMManagementPoint.

Bugs corrigidos

Corrigido um problema para o suporte ao gateway de gerenciamento de nuvem.

Set-CMProgram

Para obter mais informações, consulte set-CMProgram.

Alterações interruptivas

Renomeou o tipo RenameWithUnc para RunWithUnc para o parâmetro drivemode.

Set-CMSiteMaintenanceTask

Para obter mais informações, consulte set-CMSiteMaintenanceTask.

Alterações sem interrupção

Foram adicionados os seguintes novos parâmetros para configurar o destino de backup do site e o destino do backup do SQL para ambientes com um provedor de SMS remoto:

  • SiteBackupPath
  • SqlBackupPath

Exemplo:

Set-CMSiteMaintenanceTask -Name $TaskName  -SiteBackupPath "c:\site-backup" -SqlBackupPath "c:\sql-backup" -BeginTime (Get-Date) -DaysOfWeek Sunday,Monday -EnableAlert $true -Enabled $true

Set-CMSoftwareUpdateAutoDeploymentRule

Para obter mais informações, consulte set-CMSoftwareUpdateAutoDeploymentRule.

Bugs corrigidos

Corrigido um problema para o objeto de entrada do Get-CMSoftwareUpdateAutoDeploymentRule com a opção Fast .

Set-CMSoftwareUpdateDeploymentPackage

Para obter mais informações, consulte set-CMSoftwareUpdateDeploymentPackage.

Bugs corrigidos

Corrigido um problema para os parâmetros RemoveExpired e RemoveSuperceded.

Set-CMSoftwareUpdateGroup

Para obter mais informações, consulte set-CMSoftwareUpdateGroup.

Bugs corrigidos

Correção de um problema para adicionar atualização de software não baixada.

Set-CMStatusFilterRule

Para obter mais informações, consulte set-CMStatusFilterRule.

Bugs corrigidos

Foi corrigido um problema para o parâmetro Name para ter certeza de que ele é composto por Get-CMStatusFilterRule.

Set-CMTaskSequenceDeployment

Para obter mais informações, consulte set-CMTaskSequenceDeployment.

Bugs corrigidos

Corrigido um problema para o parâmetro ScheduleEvent.

Corrigido um problema para o parâmetro AllowFallback.

Alterações sem interrupção

Validação adicionada para o agendamento de parâmetro para evitar valor duplicado com atribuição existente.

Novos parâmetros adicionados para configurar a agenda:

  • ClearSchedule
  • RemoveSchedule
  • Addschedule

Novos parâmetros adicionados para configurar o ScheduleEvent:

  • ClearScheduleEvent
  • RemoveScheduleEvent
  • AddScheduleEvent

Exemplo:

$ReferenceDeployment | Set-CMTaskSequenceDeployment -AddSchedule $schedule1, $schedule2

$ReferenceDeployment | Set-CMTaskSequenceDeployment -AddScheduleEvent LogOn, LogOff

Set-CMTSStep*

Bugs corrigidos

Corrigido um problema de tamanho de política quando você usa várias etapas do PowerShell que contêm scripts grandes.

Set-CMTSStepEnableBitLocker

Para obter mais informações, consulte set-CMTSStepEnableBitLocker.

Bugs corrigidos

Correção de um problema para o método de criptografia especificado pelo usuário.

Set-CMTSStepOfflineEnableBitLocker

Para obter mais informações, consulte set-CMTSStepOfflineEnableBitLocker.

Bugs corrigidos

Correção de um problema para o método de criptografia especificado pelo usuário.

Set-CMTSStepPreStartCheck

Para obter mais informações, consulte set-CMTSStepPreStartCheck.

Alterações sem interrupção

Adicionado um novo parâmetro para verificação de UEFI:, CheckUefi.

Set-CMWindowsAppxDeploymentType

Para obter mais informações, consulte set-CMWindowsAppxDeploymentType.

Alterações sem interrupção

Adicionada a função para dar suporte a MSIX.

Start-CMCloudManagementGateway

Para obter mais informações, consulte Start-CMCloudManagementGateway.

Bugs corrigidos

Correção da validação para o status de CMG.

Start-CMContentDistribution

Para obter mais informações, consulte Start-CMContentDistribution.

Alterações sem interrupção

Aliases adicionados para o parâmetro DeploymentPackageId e DeploymentPackageName para melhor compreensão.

Stop-CMCloudManagementGateway

Para obter mais informações, consulte Stop-CMCloudManagementGateway.

Bugs corrigidos

Correção da validação para o status de CMG.

Como fornecer comentários ou relatar problemas

Muitas das correções e melhorias descritas neste artigo são resultado de seus comentários.

Para enviar comentários, use o console do Configuration Manager. Para obter mais informações, consulte comentários do PowerShell.

Para enviar novas solicitações de recursos, consulte o grupo PowerShell de Configuration Manager no UserVoice.