Get-CMDistributionStatus

  • Referência
Módulo:
ConfigurationManager

Obter o estado do conteúdo de um objeto.

Sintaxe

Get-CMDistributionStatus
   [-Id <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMDistributionStatus
   -InputObject <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Utilize este cmdlet para obter o estado do conteúdo de um objeto. Por exemplo, um pacote, uma aplicação ou uma imagem de arranque. Os resultados deste comando são os mesmos que são apresentados na consola do Configuration Manager na área Estado do Conteúdo do separador Resumo do painel de detalhes. Para obter mais informações, veja Monitorizar o conteúdo que distribui com o 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 o estado de uma aplicação com o respetivo ID de pacote

O primeiro comando obtém o ID do pacote de uma aplicação com o nome WebView2 Redist (x86) e armazena-o na variável PackageId. O segundo comando utiliza o ID do pacote como um parâmetro para Get-CMDistributionStatus, que obtém o estado de distribuição da aplicação.

$PackageId = (Get-CMApplication -Name 'WebView2 Redist (x86)').PackageID
Get-CMDistributionStatus -Id $PackageId

SmsProviderObjectPath : SMS_ObjectContentExtraInfo.ObjectID="ScopeId_0D7D8B60-F2F9-484A-B9F3-4A8B68D14D59/Application_8
                        8fe14d8-73b2-43bc-897e-08232861c864"
DateCreated           : 11/5/2020 12:59:19
Description           : Installs the WebView2 cab redist to the console.
FeatureType           : 8
LastUpdateDate        : 2/24/2021 00:02:47
NumberErrors          : 0
NumberInProgress      : 0
NumberSuccess         : 3
NumberUnknown         : 0
ObjectID              : ScopeId_0D7D8B60-F2F9-484A-B9F3-4A8B68D14D59/Application_88fe14d8-73b2-43bc-897e-08232861c864
ObjectType            : 512
ObjectTypeID          : 31
PackageID             : XYZ00810
SoftwareName          : WebView2 Redist (x86)
SourceSite            : XYZ
SourceSize            : 123389
SourceVersion         : 1
Targeted              : 3

Pode ver a partir deste resultado que a aplicação foi distribuída para três pontos de distribuição, porque a propriedade Targeted é 3. Também pode ver que o site distribuiu o conteúdo com êxito, porque a propriedade NumberSuccess também 3é . Para obter mais informações sobre estas propriedades, veja SMS_ObjectContentExtraInfo classe WMI de servidor.

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

-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 do pacote para o objeto obter o respetivo estado de conteúdo. Este valor é um ID de pacote padrão, por exemplo, XYZ0005E2.

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

-InputObject

Especifique um objeto para obter o respetivo estado de conteúdo. Para obter este objeto, utilize um dos seguintes cmdlets:

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject[]

Observações

Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_ObjectContentExtraInfo classe WMI de servidor.