Compartilhar via

Export-CMQuery

  • Referência
Módulo:
ConfigurationManager

Exportar uma consulta do Configuration Manager.

Sintaxe

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

Description

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

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

O Configuration Manager 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, veja Introdução às consultas 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: Exportar uma consulta

Este comando exporta uma consulta denominada Os meus sistemas para um ficheiro exportado chamado query.mof.

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

Exemplo 2: Exportar uma consulta com um comentário

Este exemplo define 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

Parâmetros

-Comment

Especifique um comentário opcional. O Configuration Manager inclui o comentário no ficheiro MOF. Se utilizar a consola do Configuration Manager para importar a consulta, o comentário é apresentado no Assistente de Importação de Objetos.

Este comentário tem um limite de 1024 carateres.

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

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-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

-ExportFilePath

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

Tipo:String
Aliases:FileName, FilePath, Path
Cargo:Named
Valor padrão:None
Obrigatório:True
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

Especifique o ID da consulta a exportar. Por exemplo, XYZ00006.

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

-InputObject

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

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

-Name

Especifique o nome da consulta a exportar.

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

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object