Freigeben über

Get-CMDistributionStatus

  • Referenz
Modul:
ConfigurationManager

Ruft den Inhaltsstatus eines Objekts ab.

Syntax

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

Beschreibung

Verwenden Sie dieses Cmdlet, um den Inhaltsstatus eines Objekts abzurufen. Beispielsweise ein Paket, eine Anwendung oder ein Startimage. Die Ergebnisse dieses Befehls entsprechen denen, die in der Configuration Manager-Konsole im Bereich Inhaltsstatus der Registerkarte Zusammenfassung des Detailbereichs angezeigt werden. Weitere Informationen finden Sie unter Überwachen von Inhalten, die Sie mit Configuration Manager verteilen.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Abrufen des Status für eine Anwendung mithilfe ihrer Paket-ID

Der erste Befehl ruft die Paket-ID einer Anwendung namens WebView2 Redist (x86) ab und speichert sie in der Variablen PackageId. Der zweite Befehl verwendet die Paket-ID als Parameter für Get-CMDistributionStatus, der den Verteilungsstatus der Anwendung abruft.

$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

Sie sehen in dieser Ausgabe, dass die Anwendung an drei Verteilungspunkte verteilt wurde, da die Targeted-Eigenschaft ist 3. Sie können auch sehen, dass die Website den Inhalt erfolgreich verteilt hat, da die NumberSuccess-Eigenschaft ebenfalls 3ist. Weitere Informationen zu diesen Eigenschaften finden Sie unter SMS_ObjectContentExtraInfo-Server-WMI-Klasse.

Parameter

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

Geben Sie die Paket-ID für das Objekt an, um den Inhaltsstatus abzurufen. Dieser Wert ist eine Standardpaket-ID, XYZ0005E2z. B. .

Typ:String
Aliase:PackageId
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Geben Sie ein Objekt an, um den Inhaltsstatus abzurufen. Verwenden Sie zum Abrufen dieses Objekts eines der folgenden Cmdlets:

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

IResultObject[]

Hinweise

Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_ObjectContentExtraInfo WMI-Serverklasse.