Share via

New-CMConfigurationItem

  • Referência
Módulo:
ConfigurationManager

Cria um item de configuração do Configuration Manager.

Syntax

New-CMConfigurationItem
   [-Category <String[]>]
   [-Description <String>]
   -Name <String>
   -ParentConfigurationItem <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMConfigurationItem
   [-Category <String[]>]
   -CreationType <CICreationType>
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet New-CMConfigurationItem cria um item de configuração no Configuration Manager. Crie itens de configuração para definir configurações que você deseja gerenciar e avaliar para conformidade em dispositivos.

Você pode especificar o parâmetro ParentConfigurationItem para criar um item de configuração filho. Itens de configuração filho no Configuration Manager são cópias de itens de configuração que mantêm uma relação com o item de configuração original; portanto, eles herdam a configuração original do item de configuração pai. Não é possível criar itens de configuração filho para dispositivos móveis.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: Criar um item de configuração

PS XYZ:\> New-CMConfigurationItem -CreationType MobileDevice -Name "MD_Config88"

Este comando cria um item de configuração para dispositivos móveis chamados MD_Config88.

Parâmetros

-Category

Especifica uma matriz de nomes localizados das categorias às quais o item de configuração pertence.

Type:String[]
Aliases:LocalizedCategoryInstanceNames
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-CreationType

Especifica o tipo de item de configuração. Os valores aceitáveis para esse parâmetro são:

  • MacOS
  • MobileDevice
  • Nenhum
  • WindowsApplication
  • WindowsOS
Type:CICreationType
Accepted values:None, WindowsApplication, WindowsOS, MacOS, MobileDevice
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Description

Especifica uma descrição para um item de configuração.

Type:String
Aliases:LocalizedDescription
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica um nome para o item de configuração.

Type:String
Aliases:LocalizedDisplayName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ParentConfigurationItem

Especifica um objeto CMConfigurationItem pai. Para obter um objeto CMConfigurationItem, use o cmdlet Get-CMConfigurationItem.

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject