Alterações na biblioteca de cmdlets do Gerenciador de Configurações para a versão 2010

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

Estas notas de versão resumem as alterações na biblioteca de cmdlets do Gerenciador de Configurações na versão 2010.

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

Observação

A versão de branch atual 2002 do Gerenciador de Configurações é a linha de base para essas alterações. Para obter mais informações, consulte Alterações na biblioteca de cmdlets do Gerenciador de Configurações 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 esses cmdlets para automatizar a criação, a configuração e o gerenciamento do serviço CMG e dos requisitos do Azure AD (Azure AD).

Observação

Embora alguns dos novos cmdlets possam funcionar com outros serviços do Azure, eles só sã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 Active Directory (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 Gerenciador de Configurações.
  2. Import-CMAADClientApplication: Crie a definição do aplicativo cliente do Azure AD no Gerenciador de Configurações.
  3. Use Get-CMAADApplication para obter os objetos de aplicativo e, em seguida, passe para New-CMCloudManagementAzureService para criar a conexão de serviço do Azure no Gerenciador de Configurações.
  4. New-CMCloudManagementGateway: Crie o serviço CMG no Azure.
  5. Add-CMCloudManagementGatewayConnectionPoint: Crie o sistema de sites do ponto de conexão CMG.

Novos cmdlets para CMG

Cmdlets atualizados para CMG

Os cmdlets existentes a seguir 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 CMG existentes:

Novos cmdlets

Gerenciamento de aplicativo

Gerenciamento de coleção

Atualização da edição do Windows 10

Perfis do navegador Microsoft Edge

Perfis do OneDrive for Business

Cmdlets preteridos e removidos

Os seguintes cmdlets para ambientes híbridos do Gerenciador de Configurações 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 está preterido:

Problemas conhecidos

Nenhum

Alterações de cmdlet

As seguintes alterações 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 listados nesta seção, examine cuidadosamente as alterações para entender como elas podem afetar seu uso.

Add-CMComplianceSettingRegistryKeyValue

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

Alterações interruptivas

O parâmetro ExpectedValue pode aceitar um valor vazio.

Add-CMDistributionPoint

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

Bugs que foram corrigidos

Correção de um problema para a criação de pontos de distribuição.

Add-CMDeviceCollectionDirectMembershipRule

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

Bugs que foram corrigidos

Foi corrigido um problema com o número de dispositivo duplicado marcar.

Add-CMManagementPoint

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

Bugs que foram corrigidos

Foi corrigido um problema de suporte ao gateway de gerenciamento de nuvem.

Add-CMPassiveSite

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

Bugs que foram corrigidos

Correção de um problema para site passivo na hierarquia.

Add-CMTaskSequenceStep

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

Bugs que foram corrigidos

Foi 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 interruptivas

Função adicionada para dar suporte ao MSIX.

Approve-CMDevice

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

Alterações interruptivas

Foi corrigido um problema ao trabalhar com Get-CMDevice.

Enable-CMSiteFeature

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

Alterações interruptivas

Adicionados novos sinalizadores para dar suporte aos recursos da nuvem.

Get-CMScript

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

Alterações interruptivas

Adicionado novo parâmetro ScriptGuid para dar suporte à consulta por script GUID.

Get-CMSiteFeature

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

Alterações interruptivas

Adicionados novos sinalizadores para dar suporte aos recursos da nuvem.

Get-CMSoftwareUpdate

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

Alterações interruptivas

Adicionado novo parâmetro Fornecedor 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 que foram corrigidos

Correção de um problema para o parâmetro ShowMessage.

Import-CMDriver

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

Alterações interruptivas

Adicionado 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 Pacote removido. Canalize o objeto package ou use o parâmetro InputObject .

Alterações interruptivas

Adicionado suporte ao pipeline e ao parâmetro InputObject .

Exemplo:

$pkg | Invoke-CMAnalyzePackage

Invoke-CMClientAction

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

Bugs que foram corrigidos

Corrigido o problema de pipeline 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 Pacote removido. Canalize o objeto package ou use o parâmetro InputObject .

Alterações interruptivas

Adicionado suporte ao pipeline e ao parâmetro InputObject .

Exemplo:

$pkg | Invoke-CMConvertPackage

Invoke-CMReport

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

Bugs que foram corrigidos

Correção de um problema para o parâmetro Path.

Invoke-CMScript

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

Alterações interruptivas

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 que foram 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 interruptivas

Adicionada opção VPN no parâmetro BoundaryType.

New-CMBootableMedia

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

Alterações interruptivas

Adicionar parâmetro SiteCode.

New-CMCloudManagementGateway

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

Alterações interruptivas

Os parâmetros a seguir são novos:

  • CARootCert
  • EnableCloudDPFunction
  • EnableStorageQuota
  • EnableTrafficOut
  • EnforceProtocol
  • Force
  • GroupName
  • IsUsingExistingGroup
  • ServerAppClientID
  • ServiceCertPassword
  • ServiceCertPath
  • Nome do Serviço
  • StorageCriticalPct
  • StorageQuotaGB
  • StorageWarningPct
  • TrafficOutStopService

Os seguintes parâmetros são atualizados:

  • CheckClientCertRevocation
  • Configuração de ambiente
  • Região
  • SubscriptionId
  • TrafficCriticalPct
  • TrafficWarningPct

Alterações interruptivas

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

  • GovernmentSubscription
  • ManagementCertificatePassword
  • ManagementCertificatePath
  • PassThru
  • RootCertificatePath
  • ServiceCertificatePassword
  • ServiceCertificatePath
  • ServiceCName

New-CMCoManagementPolicy

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

Alterações interruptivas

Aplicabilidade multissessão adicionada

Aplicabilidade ARM64 adicionada

New-CMComplianceRuleFileFolderDate

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

Alterações interruptivas

Ajustou a lógica do cmdlet para processar os valores dos parâmetros Modificação e Criação para se 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

Alteração do tipo do parâmetro ExpressionOperator de RuleExpressionOperator para o tipo FileFolderRuleExpressionOperator .

New-CMDetectionClauseFile

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

Alterações interruptivas

Alteração do tipo do parâmetro ExpressionOperator de RuleExpressionOperator para o tipo FileFolderRuleExpressionOperator .

New-CMDetectionClauseMacBundle

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

Alterações interruptivas

Alteração do tipo do parâmetro ExpressionOperator de RuleExpressionOperator para o tipo MacRuleExpressionOperator .

Bugs que foram corrigidos

Correção de um problema para o parâmetro PropertyType.

New-CMDetectionClauseMacPackage

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

Alterações interruptivas

Alteração do tipo do parâmetro ExpressionOperator de RuleExpressionOperator para o tipo MacRuleExpressionOperator .

New-CMDetectionClauseRegistryKeyValue

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

Alterações interruptivas

Alteração do tipo do parâmetro ExpressionOperator de RuleExpressionOperator para o tipo RegistryValueRuleExpressionOperator .

New-CMDetectionClauseWindowsInstaller

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

Alterações interruptivas

Alteração do tipo do parâmetro ExpressionOperator de RuleExpressionOperator para o tipo WindowsInstallerRuleExpressionOperator .

New-CMDriverPackage

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

Bugs que foram corrigidos

Foi corrigido um problema para o parâmetro DriverModel.

New-CM*PhasedDeployment

Para saber mais, confira os seguintes artigos:

Bugs que foram corrigidos

Correção de um problema para o parâmetro WhatIf.

Alterações interruptivas

Validação adicionada para nome de fase duplicado.

New-CMPrestageMedia

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

Alterações interruptivas

Adicionar parâmetro SiteCode.

New-CMProgram

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

Alterações interruptivas

O tipo RenameWithUnc foi renomeado para o RunWithUnc parâmetro DriveMode.

New-CMSoftwareUpdateDeployment

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

Alterações interruptivas

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

New-CMStandaloneMedia

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

Bugs que foram corrigidos

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

New-CMTaskSequence

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

Bugs que foram corrigidos

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

New-CMTaskSequenceDeployment

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

Bugs que foram corrigidos

Correção de um problema para o parâmetro AllowFallback.

Alterações interruptivas

Adicionada validação para o parâmetro Schedule para evitar valor duplicado com atribuição existente.

New-CMTaskSequenceMedia

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

Alterações interruptivas

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 que foram corrigidos

Correção de um problema para o parâmetro EnableQuickFormat.

New-CMTSStepEnableBitLocker

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

Bugs que foram 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 que foram 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 que foram corrigidos

Correção de um problema para a nova etapa de preparação de marca.

Correção de um problema para o parâmetro OSLanguageId.

Alterações interruptivas

Adicione um novo parâmetro para a marca UEFI, CheckUefi.

Remove-CMTaskSequenceGroup

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

Bugs que foram corrigidos

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

Set-CM*PhasedDeployment

Para saber mais, confira os seguintes artigos:

Bugs que foram corrigidos

Correção de um problema para o parâmetro WhatIf.

Set-CMBoundary

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

Alterações interruptivas

Opção adicionada VPN em BoundaryType.

Set-CMClientSettingComputerRestart

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

Alterações interruptivas

Adicionado um novo parâmetro NoRebootEnforcement.

Set-CMClientSettingSoftwareUpdate

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

Alterações interruptivas

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 interruptivas

Os parâmetros a seguir são novos:

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

Alterações interruptivas

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

  • VMInstancesCount

Set-CMDiscoveryMethod

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

Bugs que foram corrigidos

Correção de um problema para o parâmetro AddGroupDiscoveryScope.

Set-CMDistributionPoint

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

Alterações interruptivas

Parâmetros adicionados para dar suporte ao Microsoft Cache Conectado:

  • 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 que foram corrigidos

Foi corrigido um problema para o parâmetro DriverModel.

Set-CMManagementPoint

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

Bugs que foram corrigidos

Foi corrigido um problema de suporte ao gateway de gerenciamento de nuvem.

Set-CMProgram

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

Alterações interruptivas

O tipo RenameWithUnc foi renomeado para o RunWithUnc parâmetro DriveMode.

Set-CMSiteMaintenanceTask

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

Alterações interruptivas

Adicionados os seguintes novos parâmetros para configurar o destino de backup do site e o destino de backup do SQL para ambientes com um provedor 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 que foram corrigidos

Correção de um problema para o objeto de entrada de Get-CMSoftwareUpdateAutoDeploymentRule com a opção Rápido .

Set-CMSoftwareUpdateDeploymentPackage

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

Bugs que foram corrigidos

Correção de um problema para os parâmetros RemoveExpired e RemoveSuperceded.

Set-CMSoftwareUpdateGroup

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

Bugs que foram corrigidos

Foi corrigido um problema para adicionar uma atualização de software não baixada.

Set-CMStatusFilterRule

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

Bugs que foram corrigidos

Foi corrigido um problema para o parâmetro Name para garantir que ele consista em Get-CMStatusFilterRule.

Set-CMTaskSequenceDeployment

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

Bugs que foram corrigidos

Correção de um problema para o parâmetro ScheduleEvent.

Correção de um problema para o parâmetro AllowFallback.

Alterações interruptivas

Adicionada validação para o parâmetro Schedule para evitar valor duplicado com atribuição existente.

Adicionados novos parâmetros para configurar o Agendamento:

  • Limpar Cronograma
  • RemoveSchedule
  • AddSchedule

Adicionados novos parâmetros para configurar ScheduleEvent:

  • ClearScheduleEvent
  • RemoveScheduleEvent
  • AddScheduleEvent

Exemplo:

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

$ReferenceDeployment | Set-CMTaskSequenceDeployment -AddScheduleEvent LogOn, LogOff

Set-CMTSStep*

Bugs que foram corrigidos

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

Set-CMTSStepEnableBitLocker

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

Bugs que foram 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 que foram 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 interruptivas

Adicionado um novo parâmetro para a marca UEFI:, CheckUefi.

Set-CMWindowsAppxDeploymentType

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

Alterações interruptivas

Função adicionada para dar suporte ao MSIX.

Start-CMCloudManagementGateway

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

Bugs que foram corrigidos

Corrigida a validação do status do CMG.

Start-CMContentDistribution

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

Alterações interruptivas

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

Stop-CMCloudManagementGateway

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

Bugs que foram corrigidos

Corrigida a validação do status do 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 Gerenciador de Configurações. Para obter mais informações, consulte Comentários para o PowerShell.

  • Last updated on