Get-CMConfigurationItem
SYNOPSIS
Obtém itens de configuração do Gestor de Configuração.
SYNTAX
SearchByName (Padrão)
Get-CMConfigurationItem [-Fast] [[-Name] <String>] [-DisableWildcardHandling] [-ForceWildcardHandling]
[<CommonParameters>]
SearchByIdMandatory
Get-CMConfigurationItem [-Fast] [-Id] <Int32> [-DisableWildcardHandling] [-ForceWildcardHandling]
[<CommonParameters>]
DESCRIPTION
O cmdlet Get-CMConfigurationItem obtém objetos de item de configuração no Gestor de Configuração. Pode utilizar este cmdlet para obter itens para outros cmdlets utilizarem. Por exemplo, pode obter itens de configuração para que possa utilizar o Set-CMConfigurationItem para alterar as definições dos mesmos.
Os itens de configuração contêm uma ou mais configurações, juntamente com as regras de conformidade. Para obter mais informações sobre itens de configuração, consulte Introdução à conformidade Definições no Gestor de Configuração.
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: 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 para usar 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.
PARAMETERS
-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
- Rápido
Indica que o cmdlet não atualiza automaticamente as propriedades preguiçosas.
As propriedades preguiçosas contêm valores relativamente ineficientes de recuperação que podem causar tráfego adicional de rede e diminuir o desempenho do cmdlet. Se não forem necessárias propriedades preguiçosas, este parâmetro deve ser especificado.
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
- ID
Especifica uma matriz de identificadores para um ou mais itens de configuração. Pode usar uma lista separada de vírgula.
Type: Int32
Parameter Sets: SearchByIdMandatory
Aliases: CIId, CI_ID
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Especifica uma série de nomes de itens de configuração. Pode usar uma lista separada de vírgula.
Type: String
Parameter Sets: SearchByName
Aliases: LocalizedDisplayName
Required: False
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
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
Nenhuma
OUTPUTS
IResultObject[]#SMS_ConfigurationItemLatest
IResultObject#SMS_ConfigurationItemLatest
NOTAS
RELATED LINKS
Introdução ao Definições de conformidade no Gestor de Configuração
Get-CMConfigurationItemXMLDefinition
Get-CMConfigurationItemHistory