共用方式為


Get-CMConfigurationPolicyDeployment

取得設定原則部署。

語法

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

使用此 Cmdlet 來取得設定原則的一或多個部署。 這些原則包括下列類型:

  • 用戶數據和配置檔
  • 商務用 OneDrive 設定檔
  • 遠端連線配置檔
  • 公司資源存取
  • Microsoft Edge 瀏覽器配置檔

注意事項

從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet,例如 PS XYZ:\>。 如需詳細資訊,請 參閱開始使用

範例

範例 1:列出所有設定原則部署

此命令會傳回所有設定原則部署,並只顯示名稱和標識符。

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

範例 2:取得設定原則的所有部署

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

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

參數

-Collection

指定集合物件。 此集合是設定原則部署的目標。 若要取得此物件,請使用 Get-CMCollection Cmdlet。

類型:IResultObject
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-CollectionId

指定設定原則部署的目標集合標識碼。 例如,XYZ00023

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-CollectionName

指定設定原則部署的目標集合名稱。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:True

-DeploymentId

指定部署的識別碼。 這個值是標準 GUID,與控制台中的 部署標識 符相同,傳回物件上的 AssignmentUniqueID 屬性相同。

類型:String
別名:AssignmentUniqueID, ConfigurationPolicyDeploymentID
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DisableWildcardHandling

此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Fast

新增此參數,不自動重新整理延遲屬性。 延遲屬性包含相對沒有效率的擷取值。 取得這些屬性可能會導致額外的網路流量,並降低 Cmdlet 效能。

如果您未使用此參數,Cmdlet 會顯示警告。 若要停用此警告,請設定 $CMPSSuppressFastNotUsedCheck = $true

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ForceWildcardHandling

此參數會處理通配符,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-InputObject

指定設定原則物件以取得其部署。 若要取得此物件,請使用 Get-CMConfigurationPolicy Cmdlet。

類型:IResultObject
別名:ConfigurationPolicy
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Name

指定設定原則的名稱,以取得其部署。

類型:String
別名:ConfigurationPolicyName
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:True

-SmsObjectId

指定設定原則的標識碼,以取得其部署。

類型:Int32
別名:CI_ID, ConfigurationPolicyID
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Summary

新增此參數以傳回 SMS_DeploymentSummary WMI 類別 物件。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

IResultObject[]

IResultObject

IResultObject[]

IResultObject