Partilhar via


Export-CMQuery

SYNOPSIS

Exporte uma consulta do Gestor de Configuração.

SYNTAX

SearchByNameMandatory (Padrão)

Export-CMQuery [-Comment <String>] -ExportFilePath <String> -Name <String> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByIdMandatory

Export-CMQuery [-Comment <String>] -ExportFilePath <String> -Id <String> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByValueMandatory

Export-CMQuery [-Comment <String>] -ExportFilePath <String> [-InputObject] <IResultObject>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Utilize este cmdlet para exportar uma consulta do Gestor de Configuração. As consultas do Gestor de Configuração definem uma expressão WMI Query Language (WQL) para obter informações da base de dados do site com base nos critérios que fornece.

Pode exportar uma consulta para copiá-la de um site para outro. Por exemplo, copiar uma consulta de um laboratório de teste para um ambiente de produção.

O Gestor de Configuração exporta a consulta para um ficheiro de formato de objeto gerido (MOF). Em seguida, pode utilizar o cmdlet Import-CMQuery para importar a consulta para outro site.

Para obter mais informações, consulte Introdução às consultas no Gestor de Configurações.

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: Exportar uma consulta

Este comando exporta uma consulta chamada My systems para um ficheiro exportado chamado consulta.mof.

Export-CMQuery -Name "My systems" -ExportFilePath "C:\export\query.mof"

Exemplo 2: Exportar uma consulta com um comentário

Este exemplo faz um comentário no ficheiro exportado.

Export-CMQuery -Name "My Systems" -ExportFilePath "C:\Export\Query.mof" -Comment "This is a comment"
// Comments :
//
// This is a comment

PARAMETERS

-Comentário

Especifique um comentário opcional. O Gestor de Configuração inclui o comentário no ficheiro MOF. Se utilizar a consola 'Gestor de Configuração' para importar a consulta, o comentário aparece no Assistente de Objetos Importados.

Este comentário tem um limite de 1024 caracteres.

Type: String
Parameter Sets: (All)
Aliases:

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: 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

-ExportFilePath

Especifique o caminho para o ficheiro exportado. A extensão do ficheiro é .mof. Pode ser um caminho local ou de rede. Crie primeiro a pasta alvo.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
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

Especificar o ID da consulta para exportação. Por exemplo, XYZ00006.

Type: String
Parameter Sets: SearchByIdMandatory
Aliases: QueryId

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-InputObject

Especifique um objeto de consulta para exportar. Para obter este objeto, utilize o cmdlet Get-CMQuery.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases: Query

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Name

Especificar o nome da consulta para exportação.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: None
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

Sistema.Objeto

NOTAS

Get-CMQuery

Importação-CMQuery

Invocar-CMQuery

New-CMQuery

Remover-CMQuery

Set-CMQuery

Introdução a consultas no Gestor de Configuração