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

Comentários

Esta página foi útil?