Compartilhar via

Get-CMConfigurationItem

  • Referência
Módulo:
ConfigurationManager

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

Sintaxe

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. Pode utilizar este cmdlet para obter itens para outros cmdlets a utilizar. Por exemplo, poderá obter itens de configuração para poder utilizar a Set-CMConfigurationItem para alterar as definições dos mesmos.

Os itens de configuração contêm uma ou mais definições, juntamente com as regras de conformidade. Para obter mais informações sobre itens de configuração, veja Introdução às Definições de Compatibilidade no Configuration Manager.

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: Obter um item com um nome

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

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

Exemplo 2: Obter um item para utilizar 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 armazena-o na variável $CIObj.

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

Parâmetros

-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

-Fast

Indica que o cmdlet não atualiza automaticamente as propriedades em diferido.

As propriedades em diferido contêm valores relativamente ineficientes para obter, o que pode causar tráfego de rede adicional e diminuir o desempenho do cmdlet. Se não forem necessárias propriedades em diferido, este parâmetro deve ser especificado.

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

-Id

Especifica uma matriz de identificadores para um ou mais itens de configuração. Pode utilizar uma lista separada por vírgulas.

Tipo:Int32
Aliases:CIId, CI_ID
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica uma matriz de nomes de itens de configuração. Pode utilizar uma lista separada por vírgulas.

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

Entradas

None

Saídas

IResultObject[]

IResultObject