Share via


New-CMCategory

Cria uma categoria de configuração no Configuration Manager.

Syntax

New-CMCategory
   -CategoryType <CategoryType>
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet New-CMCategory cria uma categoria de configuração no Configuration Manager. As categorias de configuração oferecem um método opcional de classificação e filtragem de linhas de base de configuração e itens de configuração nos relatórios do Configuration Manager e do Configuration Manager.

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 uma categoria de configuração

PS XYZ:\> New-CMCategory -CategoryType "DriverCategories" -Name "NewLaptopDriverSet"

Este comando cria uma nova categoria em DriverCategories chamada NewLaptopDriverSet.

Parâmetros

-CategoryType

Especifica um tipo de categoria. Os valores válidos são:

  • BaselineCategories
  • DriverCategories
  • AppCategories
  • GlobalCondition
  • CatalogCategories
Type:CategoryType
Accepted values:AppCategories, BaselineCategories, CatalogCategories, DriverCategories, UserCategories
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

-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 a categoria de configuração.

Type:String
Aliases:LocalizedCategoryInstanceName
Position:Named
Default value:None
Accept pipeline input:False
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

Nenhum

Saídas

IResultObject