Share via

Get-CMConfigurationItem

  • Referência
Módulo:
ConfigurationManager

Obtém itens de configuração do Configuration Manager.

Syntax

Get-CMConfigurationItem
   [-Fast]
   [[-Name] <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMConfigurationItem
   [-Fast]
   [-Id] <Int32>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

O cmdlet Get-CMConfigurationItem obtém objetos de item de configuração no Configuration Manager. Você pode usar esse cmdlet para obter itens para outros cmdlets a usar. Por exemplo, você pode obter itens de configuração para que possa usar o Set-CMConfigurationItem para alterar as configurações neles.

Os itens de configuração contêm uma ou mais configurações, juntamente com regras de conformidade. Para obter mais informações sobre itens de configuração, consulte Introdução à conformidade Configurações no 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: Obter um item usando um nome

PS XYZ:\> Get-CMConfigurationItem -Name "ConfigItem76"

Este comando obtém um item de configuração chamado ConfigItem76.

Exemplo 2: Obter um item a ser usado com outro cmdlet

PS XYZ:\> $CIObj=Get-CMConfigurationItem -Id "16777568"
PS XYZ:\> Remove-CMConfigurationItem -InputObject $CIObj

O primeiro comando obtém um item de configuração com o identificador especificado e o armazena na $CIObj variável.

O segundo comando remove o item na variável $CIObj.

Parâmetros

-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

-Fast

Indica que o cmdlet não atualize automaticamente as propriedades de folga.

Propriedades desleixadas contêm valores relativamente ineficientes para recuperar, o que pode causar tráfego de rede adicional e diminuir o desempenho do cmdlet. Se as propriedades de folga não são necessárias, esse parâmetro deve ser especificado.

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

-Id

Especifica uma matriz de identificadores para um ou mais itens de configuração. Você pode usar uma lista separada por vírgulas.

Type:Int32
Aliases:CIId, CI_ID
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica uma matriz de nomes de itens de configuração. Você pode usar uma lista separada por vírgulas.

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

Entradas

Nenhum

Saídas

IResultObject[]

IResultObject