Share via

Get-CMDistributionStatus

  • Referência
Módulo:
ConfigurationManager

Obtenha o status de conteúdo de um objeto.

Syntax

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

Description

Use este cmdlet para obter o status de conteúdo de um objeto. Por exemplo, um pacote, um aplicativo ou uma imagem de inicialização. Os resultados desse comando são os mesmos exibidos no console Configuration Manager na área Status do Conteúdo da guia Resumo do painel de detalhes. Para obter mais informações, consulte Monitorar o conteúdo que você distribui com Configuration Manager.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: Obter status para um aplicativo usando sua ID do pacote

O primeiro comando obtém a ID do pacote de um aplicativo chamado WebView2 Redist (x86) e o armazena na variável PackageId. O segundo comando usa a ID do pacote como um parâmetro para Get-CMDistributionStatus, que obtém o status de distribuição do aplicativo.

$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

Você pode ver nesta saída que o aplicativo foi distribuído para três pontos de distribuição, porque a propriedade Targeted é 3. Você também pode ver que o site distribuiu o conteúdo com êxito, pois a propriedade NumberSuccess também 3é . Para obter mais informações sobre essas propriedades, consulte SMS_ObjectContentExtraInfo classe WMI do servidor.

Parâmetros

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

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

-Id

Especifique a ID do pacote para o objeto obter seu status de conteúdo. Esse valor é uma ID de pacote padrão, por exemplo, XYZ0005E2.

Type:String
Aliases:PackageId
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifique um objeto para obter seu status de conteúdo. Para obter esse objeto, use um dos seguintes cmdlets:

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject[]

Observações

Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_ObjectContentExtraInfo classe WMI do servidor.