Get-CMDistributionStatus
オブジェクトのコンテンツの状態を取得します。
構文
Get-CMDistributionStatus
[-Id <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Get-CMDistributionStatus
-InputObject <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
説明
オブジェクトのコンテンツの状態を取得するには、このコマンドレットを使用します。 たとえば、パッケージ、アプリケーション、ブート イメージなどです。 このコマンドの結果は、詳細ウィンドウの [概要] タブの [コンテンツの状態] 領域の Configuration Manager コンソールに表示される内容と同じです。 詳細については、「 Configuration Manager で配布するコンテンツを監視する」を参照してください。
注:
PS XYZ:\>
など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: パッケージ ID を使用してアプリケーションの状態を取得する
最初のコマンドは、 WebView2 Redist (x86) という名前のアプリケーションのパッケージ ID を取得し、変数 PackageId に格納します。 2 番目のコマンドは、 Get-CMDistributionStatus のパラメーターとしてパッケージ ID を使用します。これは、アプリケーションの配布状態を取得します。
$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
Targeted プロパティが3
されているため、この出力から、アプリケーションが 3 つの配布ポイントに配布されたことが確認できます。
また、NumberSuccess プロパティも3
されているため、サイトがコンテンツを正常に配布したことがわかります。 これらのプロパティの詳細については、「 サーバー WMI クラスSMS_ObjectContentExtraInfo」を参照してください。
パラメーター
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Id
オブジェクトのパッケージ ID を指定して、そのコンテンツの状態を取得します。 この値は、 XYZ0005E2
などの標準パッケージ ID です。
型: | String |
Aliases: | PackageId |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InputObject
コンテンツの状態を取得するオブジェクトを指定します。 このオブジェクトを取得するには、次のいずれかのコマンドレットを使用します。
- Get-CMApplication
- Get-CMBootImage
- Get-CMDriverPackage
- Get-CMOperatingSystemInstaller (OS アップグレード パッケージ)
- Get-CMOperatingSystemImage
- Get-CMPackage
- Get-CMSoftwareUpdate
- Get-CMSoftwareUpdateDeploymentPackage
型: | IResultObject |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
IResultObject[]
メモ
この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_ObjectContentExtraInfo」を参照してください。