Partilhar via


Get-CMConfigurationPolicyDeployment

SYNOPSIS

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

SYNTAX

SearchByName (Padrão)

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

SearchByDeploymentId

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

SearchByValue

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

SearchById

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:

  • Dados e Perfis do Utilizador
  • perfis OneDrive para Empresas
  • Perfis de Conexão Remota
  • Acesso aos Recursos da Empresa
  • Microsoft Edge Perfis de navegador

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: Listar todas as implementações de políticas de configuração

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

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

Exemplo 2: Obtenha 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

PARAMETERS

-Coleção

Especifique um objeto de coleção. Esta recolha é o alvo para a implementação da política de configuração. Para obter este objeto, utilize o cmdlet Get-CMCollection.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-CollectionId

Especifique um ID de recolha que é o alvo para a implementação da política de configuração. Por exemplo, XYZ00023.

Type: String
Parameter Sets: (All)
Aliases:

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

-Nome de coleção

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

Type: String
Parameter Sets: (All)
Aliases:

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

-DeploymentId

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

Type: String
Parameter Sets: SearchByDeploymentId
Aliases: AssignmentUniqueID, ConfigurationPolicyDeploymentID

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

-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

- Rápido

Adicione este parâmetro para não atualizar automaticamente as propriedades preguiçosas. As propriedades preguiçosas contêm valores que são relativamente ineficientes de recuperação. Obter estas propriedades pode causar tráfego adicional de rede e diminuir o desempenho do cmdlet.

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

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

-InputObject

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

Type: IResultObject
Parameter Sets: SearchByValue
Aliases: ConfigurationPolicy

Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Name

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

Type: String
Parameter Sets: SearchByName
Aliases: ConfigurationPolicyName

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

-SmsObjectId

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

Type: Int32
Parameter Sets: SearchById
Aliases: CI_ID, ConfigurationPolicyID

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

-Resumo

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
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_DeploymentSummary

IResultObject#SMS_DeploymentSummary

IResultObject[]#SMS_ConfigurationPolicyAssignment

IResultObject#SMS_ConfigurationPolicyAssignment

NOTAS

Novo CMConfigurationPolicyDeployment

Remover-CMConfigurationPolicyDeployment

Set-CMConfigurationPolicyDeployment

Get-CMConfigurationPolicy