Compartilhar via

New-CMConfigurationItem

  • Referência
Módulo:
ConfigurationManager

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

Sintaxe

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 as configurações que pretende gerir e avaliar relativamente à compatibilidade nos dispositivos.

Pode especificar o parâmetro ParentConfigurationItem para criar um item de configuração subordinado. Os itens de configuração subordinados 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; Por conseguinte, herdam a configuração original do item de configuração principal. Não é possível criar itens de configuração subordinados para dispositivos móveis.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

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 com o nome MD_Config88.

Parâmetros

-Category

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

Tipo:String[]
Aliases:LocalizedCategoryInstanceNames
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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
Tipo:CICreationType
Valores aceitos:None, WindowsApplication, WindowsOS, MacOS, MobileDevice
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Description

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

Tipo:String
Aliases:LocalizedDescription
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

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

Tipo:String
Aliases:LocalizedDisplayName
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ParentConfigurationItem

Especifica um objeto CMConfigurationItem principal. Para obter um objeto CMConfigurationItem , utilize o cmdlet Get-CMConfigurationItem .

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject