Partager via

Get-CMDistributionStatus

  • Référence
Module:
ConfigurationManager

Obtient l’état du contenu d’un objet.

Syntaxe

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

Description

Utilisez cette applet de commande pour obtenir l’état du contenu d’un objet. Par exemple, un package, une application ou une image de démarrage. Les résultats de cette commande sont les mêmes que ceux affichés dans la console Configuration Manager dans la zone État du contenu de l’onglet Résumé du volet d’informations. Pour plus d’informations, consultez Surveiller le contenu que vous distribuez avec Configuration Manager.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Obtenir l’état d’une application à l’aide de son ID de package

La première commande obtient l’ID de package d’une application nommée WebView2 Redist (x86) et le stocke dans la variable PackageId. La deuxième commande utilise l’ID de package comme paramètre pour Get-CMDistributionStatus, qui obtient l’état de distribution de l’application.

$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

Vous pouvez voir à partir de cette sortie que l’application a été distribuée à trois points de distribution, car la propriété Targeted est 3. Vous pouvez également voir que le site a correctement distribué le contenu, car la propriété NumberSuccess est également 3. Pour plus d’informations sur ces propriétés, consultez SMS_ObjectContentExtraInfo classe WMI du serveur.

Paramètres

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Id

Spécifiez l’ID de package pour l’objet afin d’obtenir son état de contenu. Cette valeur est un ID de package standard, par exemple . XYZ0005E2

Type:String
Alias:PackageId
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Spécifiez un objet pour obtenir son état de contenu. Pour obtenir cet objet, utilisez l’une des applets de commande suivantes :

Type:IResultObject
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

IResultObject[]

Notes

Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_ObjectContentExtraInfo classe WMI du serveur.