New-CMConfigurationItem
SYNOPSIS
Cria um item de configuração do Gestor de Configuração.
SYNTAX
NewChild (Padrão)
New-CMConfigurationItem [-Category <String[]>] [-Description <String>] -Name <String>
-ParentConfigurationItem <IResultObject> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
[-Confirm] [<CommonParameters>]
Novo
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 Gestor de Configuração. Crie itens de configuração para definir configurações que pretende gerir e avaliar para a conformidade nos dispositivos.
Pode especificar o parâmetro ParentConfigurationItem para criar um item de configuração infantil. Os itens de configuração infantil no Gestor de Configuração são cópias de itens de configuração que mantêm uma relação com o item de configuração original; portanto, herdam a configuração original do item de configuração dos pais. Não é possível criar itens de configuração infantil para dispositivos móveis.
Nota
Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.
EXAMPLES
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 denominados MD_Config88.
PARAMETERS
-Categoria
Especifica uma série de nomes localizados das categorias a que pertence o item de configuração.
Type: String[]
Parameter Sets: (All)
Aliases: LocalizedCategoryInstanceNames
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Criação DeTipus
Especifica o tipo de item de configuração. Os valores aceitáveis para este parâmetro são:
- MacOS
- MobileDevice
- Nenhuma
- WindowsApplication
- WindowsOS
Type: CICreationType
Parameter Sets: New
Aliases:
Accepted values: None, WindowsApplication, WindowsOS, MacOS, MobileDevice
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Descrição
Especifica uma descrição para um item de configuração.
Type: String
Parameter Sets: (All)
Aliases: LocalizedDescription
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
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
Parameter Sets: (All)
Aliases: LocalizedDisplayName
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ParentConfigurationItem
Especifica um objeto CMConfigurationItem. Para obter um objeto CMConfigurationItem, utilize o cmdlet Get-CMConfigurationItem.
Type: IResultObject
Parameter Sets: NewChild
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
- O QueIf
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
IResultObject#SMS_ConfigurationItem
NOTAS
RELATED LINKS
Introdução ao Definições de conformidade no Gestor de Configuração
Get-CMConfigurationItemXMLDefinition
Get-CMConfigurationItemHistory