Get-CMDistributionStatus
SYNOPSIS
Obtenha o estado de conteúdo de um objeto.
SYNTAX
SearchById (Padrão)
Get-CMDistributionStatus [-Id <String>] [-DisableWildcardHandling] [-ForceWildcardHandling]
[<CommonParameters>]
SearchByValue
Get-CMDistributionStatus -InputObject <IResultObject> [-DisableWildcardHandling] [-ForceWildcardHandling]
[<CommonParameters>]
DESCRIPTION
Utilize este cmdlet para obter o estado de conteúdo de um objeto. Por exemplo, um pacote, uma aplicação ou uma imagem de arranque. Os resultados deste comando são os mesmos que os apresentados na consola 'Gestor de Configuração' na área de Estado do Conteúdo do separador Resumo do painel de detalhes. Para obter mais informações, consulte o conteúdo do Monitor que distribui com o Gestor de Configuração.
Nota
Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\>
. Para mais informações, consulte a partida.
EXAMPLES
Exemplo 1: Obter o estado de uma aplicação utilizando o seu ID de pacote
O primeiro comando obtém o ID do pacote de uma aplicação chamada WebView2 Redist (x86) e armazena-o na variável PackageId. O segundo comando utiliza o ID do pacote como parâmetro para Get-CMDistributionStatus, que obtém o estado de distribuição da aplicação.
$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
Pode ver por esta saída que a aplicação foi distribuída por três pontos de distribuição, porque a propriedade visada é 3
. Também pode ver que o site distribuiu com sucesso o conteúdo, porque a propriedade NumberSuccess também é 3
. Para obter mais informações sobre estas propriedades, consulte SMS_ObjectContentExtraInfo classe WMI do servidor.
PARAMETERS
-DisableWildcardHandling
Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- ID
Especifique o ID do pacote para que o objeto obtenha o seu estado de conteúdo. Este valor é um ID de pacote padrão, por exemplo, XYZ0005E2
.
Type: String
Parameter Sets: SearchById
Aliases: PackageId
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Especifique um objeto para obter o seu estado de conteúdo. Para obter este objeto, utilize um dos seguintes cmdlets:
- Get-CMApplication
- Get-CMBootImage
- Get-CMDriverPackage
- Get-CMOperatingSystemInstaller (pacote de upgrade do SISTEMA)
- Get-CMOperatingSystemImage
- Get-CMPackage
- Get-CMSoftwareUpdate
- Get-CMSoftwareUpdateDeploymentPackage
Type: IResultObject
Parameter Sets: SearchByValue
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
IResultObject[]#SMS_ObjectContentExtraInfo, IResultObject#SMS_ObjectContentExtraInfo
NOTAS
Para obter mais informações sobre este objeto de retorno e suas propriedades, consulte SMS_ObjectContentExtraInfo classe WMI do servidor.
RELATED LINKS
Monitorize o conteúdo que distribui com o Gestor de Configuração