Condividi tramite

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

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

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

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre 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 raccolta. Questa raccolta è la destinazione per la distribuzione dei criteri di configurazione. Per ottenere questo oggetto, usare il cmdlet Get-CMCollection .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CollectionId

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CollectionName

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-DeploymentId

Specificare l'ID della distribuzione. Questo valore è un GUID standard, lo stesso dell'ID di distribuzione nella console e dell'attributo AssignmentUniqueID nell'oggetto restituito.

Tipo:String
Alias:AssignmentUniqueID, ConfigurationPolicyDeploymentID
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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 traffico di rete aggiuntivo e ridurre le prestazioni dei cmdlet.

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

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

Tipo:IResultObject
Alias:ConfigurationPolicy
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

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

Tipo:String
Alias:ConfigurationPolicyName
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-SmsObjectId

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

Tipo:Int32
Alias:CI_ID, ConfigurationPolicyID
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Summary

Aggiungere questo parametro per restituire l'oggetto classe WMI SMS_DeploymentSummary .

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

IResultObject[]

IResultObject

IResultObject[]

IResultObject