Get-CMConfigurationPolicyDeployment

Riferimento

Modulo:: ConfigurationManager

Ottenere una distribuzione dei criteri di configurazione.

Sintassi

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>]

Descrizione

Utilizzare questo cmdlet per ottenere una o più distribuzioni per un criterio di configurazione. Questi criteri includono i tipi seguenti:

Profili e dati utente
OneDrive for Business profili
Profili di connessione remota
Accesso alle risorse aziendali
Microsoft Edge Profili browser

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\> . Per ulteriori informazioni, vedere Introduzione.

Esempio

Esempio 1: elencare tutte le distribuzioni dei criteri di configurazione

Questo comando restituisce tutte le distribuzioni dei criteri di configurazione e visualizza solo il nome e l'ID.

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

Esempio 2: Ottenere tutte le distribuzioni per un criterio di configurazione

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

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

Parametri

-Collection

Specificare un oggetto insieme. Questa raccolta è la destinazione per la distribuzione dei criteri di configurazione. Per ottenere questo oggetto, utilizzare il cmdlet Get-CMCollection.

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

-CollectionId

Specificare un ID raccolta che sia la destinazione per la distribuzione dei criteri di configurazione. Ad esempio, XYZ00023.

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

-CollectionName

Specificare un nome di raccolta che sia la destinazione per la distribuzione dei criteri di configurazione.

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

-DeploymentId

Specificare l'ID della distribuzione. Questo valore è un GUID standard, uguale all'ID distribuzione nella console e all'attributo AssignmentUniqueID nell'oggetto restituito.

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

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

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

-Fast

Aggiungere questo parametro per non aggiornare automaticamente le proprietà lazy. Le proprietà lazy contengono valori relativamente inefficienti da recuperare. Il recupero di queste proprietà può causare ulteriore traffico di rete e ridurre le prestazioni dei cmdlet.

Se non si utilizza questo parametro, il cmdlet visualizza un avviso. Per disabilitare questo avviso, impostare $CMPSSuppressFastNotUsedCheck = $true .

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

-ForceWildcardHandling

Questo parametro elabora i caratteri jolly e può causare un comportamento imprevisto (scelta non consigliata). Non è possibile combinarlo con DisableWildcardHandling.

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

-InputObject

Specificare un oggetto criteri di configurazione per ottenere le relative distribuzioni. Per ottenere questo oggetto, utilizzare il cmdlet Get-CMConfigurationPolicy.

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

-Name

Specificare il nome di un criterio di configurazione per ottenere le distribuzioni.

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

-SmsObjectId

Specificare l'ID di un criterio di configurazione per ottenere le distribuzioni.

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

-Summary

Aggiungere questo parametro per restituire l'SMS_DeploymentSummary classe WMI.

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

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

IResultObject[]

IResultObject