Compartilhar via


Get-CMConfigurationPolicyDeployment

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

Sintaxe

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

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

  • Perfis e Dados de Utilizador
  • Perfis do OneDrive para Empresas
  • Perfis de Ligação Remota
  • Acesso a Recursos da Empresa
  • Perfis do Browser Microsoft Edge

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Listar todas as implementações de políticas de configuração

Este comando devolve todas as implementações de políticas de configuração e apresenta apenas o nome e o ID.

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

Exemplo 2: Obter todas as implementaçõ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 de coleção. Esta coleção é o destino da implementação da política de configuração. Para obter este objeto, utilize o cmdlet Get-CMCollection .

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CollectionId

Especifique um ID de coleção que seja o destino da implementação da política de configuração. Por exemplo, XYZ00023.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CollectionName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-DeploymentId

Especifique o ID da implementação. Este valor é um GUID padrão, o mesmo que o ID de Implementação na consola do e o atributo AssignmentUniqueID no objeto devolvido.

Tipo:String
Aliases:AssignmentUniqueID, ConfigurationPolicyDeploymentID
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Fast

Adicione este parâmetro para não atualizar automaticamente as propriedades em diferido. As propriedades em diferido contêm valores relativamente ineficientes a obter. Obter estas propriedades pode causar tráfego de rede adicional e diminuir o desempenho do cmdlet.

Se não utilizar este parâmetro, o cmdlet apresenta um aviso. Para desativar este aviso, defina $CMPSSuppressFastNotUsedCheck = $true.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifique um objeto de política de configuração para obter as respetivas implementações. Para obter este objeto, utilize o cmdlet Get-CMConfigurationPolicy .

Tipo:IResultObject
Aliases:ConfigurationPolicy
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Especifique o nome de uma política de configuração para obter as respetivas implementações.

Tipo:String
Aliases:ConfigurationPolicyName
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-SmsObjectId

Especifique o ID de uma política de configuração para obter as respetivas implementações.

Tipo:Int32
Aliases:CI_ID, ConfigurationPolicyID
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Summary

Adicione este parâmetro para devolver o objeto de classe WMI SMS_DeploymentSummary .

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject[]

IResultObject

IResultObject[]

IResultObject