Get-CMDistributionStatus
Получение состояния содержимого объекта.
Синтаксис
Get-CMDistributionStatus
[-Id <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Get-CMDistributionStatus
-InputObject <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Описание
Используйте этот командлет для получения состояния содержимого объекта. Например, пакет, приложение или загрузочный образ. Результаты этой команды совпадают с результатами, которые отображаются в консоли Configuration Manager в области Состояние содержимого на вкладке Сводка области сведений. Дополнительные сведения см. в разделе Мониторинг содержимого, распространяемого с помощью Configuration Manager.
Примечание.
Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>
. Дополнительные сведения см. в статье Начало работы.
Примеры
Пример 1. Получение состояния для приложения с помощью идентификатора пакета
Первая команда получает идентификатор пакета приложения с именем WebView2 Redist (x86) и сохраняет его в переменной PackageId. Вторая команда использует идентификатор пакета в качестве параметра для Get-CMDistributionStatus, который получает состояние распространения приложения.
$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
. Вы также можете увидеть, что сайт успешно распространил содержимое, так как свойство NumberSuccess также 3
имеет значение . Дополнительные сведения об этих свойствах см . в разделе SMS_ObjectContentExtraInfo класс WMI сервера.
Параметры
-DisableWildcardHandling
Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ForceWildcardHandling
Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Id
Укажите идентификатор пакета для объекта, чтобы получить его состояние содержимого. Это значение является стандартным идентификатором пакета, например XYZ0005E2
.
Тип: | String |
Aliases: | PackageId |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-InputObject
Укажите объект, чтобы получить состояние его содержимого. Чтобы получить этот объект, используйте один из следующих командлетов:
- Get-CMApplication
- Get-CMBootImage
- Get-CMDriverPackage
- Get-CMOperatingSystemInstaller (пакет обновления ОС)
- Get-CMOperatingSystemImage
- Get-CMPackage
- Get-CMSoftwareUpdate
- Get-CMSoftwareUpdateDeploymentPackage
Тип: | IResultObject |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
Входные данные
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Выходные данные
IResultObject[]
Примечания
Дополнительные сведения об этом возвращаемом объекте и его свойствах см . в разделе SMS_ObjectContentExtraInfo класс WMI сервера.