{"content":"<div></div>","rawMetadata":{"metadata":{"_op_canonicalUrlPrefix":"https://learn.microsoft.com/pt-br/powershell/","_op_gitContributorInformation":{"author":{"display_name":"Banreet Kaur","id":"92906285","name":"Banreet","profile_url":"https://github.com/Banreet"},"contributors":[{"display_name":"Aaron Czechowski","id":"26784733","name":"aczechowski","profile_url":"https://github.com/aczechowski"},{"display_name":"Dan Mabee","id":"40476441","name":"damabe","profile_url":"https://github.com/damabe"},{"display_name":"sankethka","id":"16908144","name":"sankethka","profile_url":"https://github.com/sankethka"}],"update_at":"21/08/2026","updated_at_date_time":"2026-08-21T08:55:56.0190764Z"},"_path":"module/configurationmanager/new-cmclientsettingdeployment.json","_rel":"../../","_tocRel":"../sccm-ps/toc.json","apiPlatform":"powershell","author":"Banreet","breadcrumb_path":"/powershell/sccm/bread/toc.json","canonical_url":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/new-cmclientsettingdeployment?view=sccm-ps","content_git_url":"https://github.com/MicrosoftDocs/sccm-docs-powershell-ref/blob/main/sccm-ps/ConfigurationManager/New-CMClientSettingDeployment.md","default_moniker":"sccm-ps","depot_name":"MSDN.sccm-powershell","description":"Implante uma configuração personalizada de cliente.","external help file":"AdminUI.PS.dll-Help.xml","feedback_product_url":"https://feedbackportal.microsoft.com/feedback/forum/4669adfc-ee1b-ec11-b6e7-0022481f8472","feedback_system":"Standard","git_commit_id":"48cf632fb4b9ad92060012681a500478254de750","gitcommit":"https://github.com/MicrosoftDocs/sccm-docs-powershell/blob/48cf632fb4b9ad92060012681a500478254de750/sccm-ps/ConfigurationManager/New-CMClientSettingDeployment.md","github_contributors":["aczechowski","damabe","sankethka"],"locale":"pt-br","manager":"laurawi","Module Name":"ConfigurationManager","monikers":["sccm-ps"],"ms.author":"dannygu","ms.date":"08/02/2021","ms.service":"microsoft-endpoint-configuration-manager","ms.subservice":"other","ms.topic":"reference","open_to_public_contributors":true,"original_content_git_url":"https://github.com/MicrosoftDocs/sccm-docs-powershell/blob/live/sccm-ps/ConfigurationManager/New-CMClientSettingDeployment.md","original_content_git_url_template":"{repo}/blob/{branch}/sccm-ps/ConfigurationManager/New-CMClientSettingDeployment.md","PlatyPS schema version":"2.0.0","products":["https://authoring-docs-microsoft.poolparty.biz/devrel/f1499c3b-793f-48c3-a9ce-20285bcc6541"],"site_name":"Docs","title":"New-CMClientSettingDeployment","titleSuffix":"Configuration Manager","uhfHeaderId":"MSDocsHeader-Powershell","updated_at":"2026-08-21 08:55 AM","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/new-cmclientsettingdeployment","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMClientSettingDeployment","schemaType":"PowershellCmdlet","summary":"<p>Implante uma configuração personalizada de cliente.</p>\n","uid":"ConfigurationManager.New-CMClientSettingDeployment"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.New-CMClientSettingDeployment":{"href":"new-cmclientsettingdeployment","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMClientSettingDeployment","schemaType":"PowershellCmdlet","summary":"<p>Implante uma configuração personalizada de cliente.</p>\n","uid":"ConfigurationManager.New-CMClientSettingDeployment"}},"description":"<p>Use este cmdlet para implantar uma configuração de cliente personalizada. Quando você implanta configurações personalizadas, elas substituem as configurações padrão do cliente. As configurações personalizadas do cliente com prioridade mais alta também podem substituir outras configurações. Para obter mais informações, consulte <a href=\"/mem/configmgr/core/clients/deploy/configure-client-settings#create-and-deploy-custom-client-settings\">Criar e implantar configurações personalizadas do cliente</a>.</p>\n<div class=\"NOTE\">\n<p>Observação</p>\n<p>Execute cmdlets do Configuration Manager na unidade do site do Configuration Manager, por exemplo<code>PS XYZ:\\&gt;</code>. Para obter mais informações, consulte <a href=\"/powershell/sccm/overview\">introdução</a>.</p>\n</div>\n","examples":[{"code":"New-CMClientSettingDeployment -Id \"16777225\" -CollectionName \"General Computer Collection\"","description":"","summary":"","title":"Exemplo 1: implantar um objeto de configuração do cliente usando sua ID em uma coleção nomeada"}],"inputs":[{"description":"","name":"<span class=\"no-loc xref\">Microsoft.ConfigurationManagement.ManagementProvider.IResultObject</span>\n"}],"links":[{"href":"get-cmclientsettingdeployment","text":"Get-CMClientSettingDeployment"},{"href":"remove-cmclientsettingdeployment","text":"Remove-CMClientSettingDeployment"},{"href":"get-cmclientsetting","text":"Get-CMClientSetting"},{"href":"/mem/configmgr/core/clients/deploy/configure-client-settings#create-and-deploy-custom-client-settings","text":"Criar e implantar configurações de cliente personalizadas"}],"module":"ConfigurationManager","name":"New-CMClientSettingDeployment","notes":"","outputs":[{"description":"","name":"<span class=\"no-loc xref\">System.Object</span>\n"}],"parameters":[{"aliases":"","defaultValue":"None","description":"<p>Especifique um objeto de coleção como o destino para a implantação. Para obter esse objeto, use o cmdlet <a href=\"get-cmcollection\">Get-CMCollection</a> .</p>\n","name":"Collection","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">IResultObject</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Especifique uma ID para a coleção destinada a essa implantação. Esse valor é uma ID de coleção padrão, por exemplo, <code>XYZ00042</code>.</p>\n","name":"CollectionId","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"acceptWildcardCharacters":true,"aliases":"","defaultValue":"None","description":"<p>Especifique um nome de coleção para direcionar essa implantação.</p>\n","name":"CollectionName","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"aliases":"cf","defaultValue":"None","description":"<p>Solicita a confirmação antes de executar o cmdlet.</p>\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Esse parâmetro trata caracteres curinga como valores de caracteres literais. Você não pode combiná-lo com <strong>ForceWildcardHandling</strong>.</p>\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com <strong>DisableWildcardHandling</strong>.</p>\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"ClientSettingId","defaultValue":"None","description":"<p>Especifique a ID das configurações de cliente personalizadas a serem implantadas. Essa ID é a <strong>ID de Configurações</strong> no console e a propriedade <strong>SettingsID</strong> na <strong>classe WMI SMS_ClientSettings</strong> .</p>\n<p>Você pode usar o cmdlet <a href=\"get-cmclientsetting\">Get-CMClientSetting</a> para obter essa propriedade. Por exemplo, <code>(Get-CMClientSetting -Name &quot;Remote control&quot;).SettingsID</code></p>\n","isRequired":true,"name":"Id","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"aliases":"ClientSetting","defaultValue":"None","description":"<p>Especifique um objeto de configurações de cliente personalizado a ser implantado. Para obter esse objeto, use o cmdlet <a href=\"get-cmclientsetting\">Get-CMClientSetting</a> .</p>\n","isRequired":true,"name":"InputObject","parameterValueGroup":"","pipelineInput":true,"position":"Named","type":"<span class=\"no-loc xref\">IResultObject</span>\n"},{"aliases":"ClientSettingName","defaultValue":"None","description":"<p>Especifique o nome das configurações de cliente personalizadas a serem implantadas.</p>\n","isRequired":true,"name":"Name","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">String</span>\n"},{"aliases":"wi","defaultValue":"None","description":"<p>Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.</p>\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"}],"schema":"PowershellCmdlet","summary":"<p>Implante uma configuração personalizada de cliente.</p>\n","syntaxes":["New-CMClientSettingDeployment -Name <String> [-Collection <IResultObject>] [-CollectionId <String>]\n [-CollectionName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]\n [<CommonParameters>]","New-CMClientSettingDeployment -Id <String> [-Collection <IResultObject>] [-CollectionId <String>]\n [-CollectionName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]\n [<CommonParameters>]","New-CMClientSettingDeployment -InputObject <IResultObject> [-Collection <IResultObject>]\n [-CollectionId <String>] [-CollectionName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling]\n [-WhatIf] [-Confirm] [<CommonParameters>]"],"uid":"ConfigurationManager.New-CMClientSettingDeployment","hideEdit":true,"ms.translationtype":"MT","ms.contentlocale":"pt-br","loc_version":"2024-08-21T21:18:36.7205003Z","loc_source_id":"Github-72476255#live","loc_file_id":"Github-72476255.live.MSDN.sccm-powershell.sccm-ps/ConfigurationManager/New-CMClientSettingDeployment.md","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/new-cmclientsettingdeployment","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMClientSettingDeployment","schemaType":"PowershellCmdlet","summary":"<p>Implante uma configuração personalizada de cliente.</p>\n","uid":"ConfigurationManager.New-CMClientSettingDeployment"}],"canonical_url":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/new-cmclientsettingdeployment?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/new-cmclientsettingdeployment?view=sccm-ps"},"pageMetadata":"<meta name=\"description\" content=\"<p>Use este cmdlet para implantar uma configuração de cliente personalizada. Quando você implanta configurações personalizadas, elas substituem as configurações padrão do cliente. As configurações personalizadas do cliente com prioridade mais alta também podem substituir outras configurações. Para obter mais informações, consulte <a href=&quot;/mem/configmgr/core/clients/deploy/configure-client-settings#create-and-deploy-custom-client-settings&quot;>Criar e implantar configurações personalizadas do cliente</a>.</p>\n<div class=&quot;NOTE&quot;>\n<p>Observação</p>\n<p>Execute cmdlets do Configuration Manager na unidade do site do Configuration Manager, por exemplo<code>PS XYZ:\\&amp;gt;</code>. Para obter mais informações, consulte <a href=&quot;/powershell/sccm/overview&quot;>introdução</a>.</p>\n</div>\n\" />\r\n<meta name=\"hideEdit\" content=\"true\" />\r\n<meta name=\"loc_file_id\" content=\"Github-72476255.live.MSDN.sccm-powershell.sccm-ps/ConfigurationManager/New-CMClientSettingDeployment.md\" />\r\n<meta name=\"loc_source_id\" content=\"Github-72476255#live\" />\r\n<meta name=\"loc_version\" content=\"2024-08-21T21:18:36.7205003Z\" />\r\n<meta name=\"module\" content=\"ConfigurationManager\" />\r\n<meta name=\"ms.contentlocale\" content=\"pt-br\" />\r\n<meta name=\"ms.translationtype\" content=\"MT\" />\r\n<meta name=\"name\" content=\"New-CMClientSettingDeployment\" />\r\n<meta name=\"notes\" content=\"\" />\r\n<meta name=\"schema\" content=\"PowershellCmdlet\" />\r\n<meta name=\"summary\" content=\"<p>Implante uma configuração personalizada de cliente.</p>\n\" />\r\n<meta name=\"syntaxes\" content=\"New-CMClientSettingDeployment -Name <String> [-Collection <IResultObject>] [-CollectionId <String>]\n [-CollectionName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]\n [<CommonParameters>]\" />\r\n<meta name=\"syntaxes\" content=\"New-CMClientSettingDeployment -Id <String> [-Collection <IResultObject>] [-CollectionId <String>]\n [-CollectionName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]\n [<CommonParameters>]\" />\r\n<meta name=\"syntaxes\" content=\"New-CMClientSettingDeployment -InputObject <IResultObject> [-Collection <IResultObject>]\n [-CollectionId <String>] [-CollectionName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling]\n [-WhatIf] [-Confirm] [<CommonParameters>]\" />\r\n<meta name=\"uid\" content=\"ConfigurationManager.New-CMClientSettingDeployment\" />\r\n","themesRelativePathToOutputRoot":"_themes/"}