Share via

Get-CMConfigurationPolicyDeployment

  • Referência
Módulo:
ConfigurationManager

Obter uma implantação de política de configuração.

Syntax

Get-CMConfigurationPolicyDeployment
   [-Fast]
   [-Name <String>]
   [-Summary]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMConfigurationPolicyDeployment
   [-Fast]
   [-DeploymentId <String>]
   [-Summary]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMConfigurationPolicyDeployment
   [-Fast]
   [-InputObject <IResultObject>]
   [-Summary]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMConfigurationPolicyDeployment
   [-Fast]
   [-SmsObjectId <Int32>]
   [-Summary]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Use este cmdlet para obter uma ou mais implantações para uma política de configuração. Essas políticas incluem os seguintes tipos:

  • Dados e Perfis do Usuário
  • OneDrive for Business perfis
  • Perfis de conexão remota
  • Acesso a Recursos da Empresa
  • Microsoft Edge Perfis de navegador

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: Listar todas as implantações de política de configuração

Este comando retorna todas as implantações de política de configuração e exibe apenas o nome e a ID.

Get-CMConfigurationPolicyDeployment -Fast | Select-Object AssignmentName,AssignmentID

Exemplo 2: Obter todas as implantações para uma política de configuração

$policy = Get-CMConfigurationPolicy -Name "ODfB policy" -Fast

Get-CMConfigurationPolicyDeployment -InputObject $policy -Fast | Select-Object TargetCollectionID,StartTime,Enabled

Parâmetros

-Collection

Especifique um objeto collection. Essa coleção é o destino da implantação da política de configuração. Para obter esse objeto, use o cmdlet Get-CMCollection.

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CollectionId

Especifique uma ID de coleção que é o destino para a implantação da política de configuração. Por exemplo, XYZ00023.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CollectionName

Especifique um nome de coleção que é o destino para a implantação da política de configuração.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-DeploymentId

Especifique a ID da implantação. Esse valor é um GUID padrão, o mesmo que a ID de Implantação no console e o atributo AssignmentUniqueID no objeto retornado.

Type:String
Aliases:AssignmentUniqueID, ConfigurationPolicyDeploymentID
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Fast

Adicione esse parâmetro para não atualizar automaticamente as propriedades desleisadas. Propriedades flexíveis contêm valores relativamente ineficientes para recuperar. Obter essas propriedades pode causar tráfego de rede adicional e diminuir o desempenho do cmdlet.

Se você não usar esse parâmetro, o cmdlet exibirá um aviso. Para desabilitar esse aviso, de definir $CMPSSuppressFastNotUsedCheck = $true .

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifique um objeto de política de configuração para obter suas implantações. Para obter esse objeto, use o cmdlet Get-CMConfigurationPolicy.

Type:IResultObject
Aliases:ConfigurationPolicy
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifique o nome de uma política de configuração para obter suas implantações.

Type:String
Aliases:ConfigurationPolicyName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-SmsObjectId

Especifique a ID de uma política de configuração para obter suas implantações.

Type:Int32
Aliases:CI_ID, ConfigurationPolicyID
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Summary

Adicione esse parâmetro para retornar o objeto SMS_DeploymentSummary classe WMI.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject[]

IResultObject

IResultObject[]

IResultObject