Get-CMConfigurationPolicyDeployment
SYNOPSIS
Hämta en distribution av konfigurationsprincipen.
SYNTAX
SearchByName (standard)
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
Använd den här cmdleten för att hämta en eller flera distributioner för en konfigurationsprincip. Dessa principer omfattar följande typer:
- Användardata och profiler
- OneDrive för företag profiler
- Fjärranslutningsprofiler
- Åtkomst till företagsresurser
- Microsoft Edge Webbläsarprofiler
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenhet, till exempel PS XYZ:\> . Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Lista alla distributioner av konfigurationsprinciper
Det här kommandot returnerar alla konfigurationsprincipdistributioner och visar endast namn och ID.
Get-CMConfigurationPolicyDeployment -Fast | Select-Object AssignmentName,AssignmentID
Exempel 2: Hämta alla distributioner för en konfigurationsprincip
$policy = Get-CMConfigurationPolicy -Name "ODfB policy" -Fast
Get-CMConfigurationPolicyDeployment -InputObject $policy -Fast | Select-Object TargetCollectionID,StartTime,Enabled
PARAMETERS
-Samling
Ange ett samlingsobjekt. Den här samlingen är målet för distributionen av konfigurationsprincipen. Hämta det här objektet med hjälp av cmdleten Get-CMCollection.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionId
Ange ett samlings-ID som är målet för distributionen av konfigurationsprincipen. Till exempel XYZ00023.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Ange ett samlingsnamn som är målet för distributionen av konfigurationsprincipen.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-DeploymentId
Ange ID för distributionen. Det här värdet är ett standard-GUID, samma som distributions-ID:t i -konsolen och attributet AssignmentUniqueID för det returnerade objektet.
Type: String
Parameter Sets: SearchByDeploymentId
Aliases: AssignmentUniqueID, ConfigurationPolicyDeploymentID
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Snabb
Lägg till den här parametern för att inte uppdatera lazy-egenskaper automatiskt. Lazy-egenskaper innehåller värden som är relativt ineffektiva att hämta. Att hämta dessa egenskaper kan orsaka ytterligare nätverkstrafik och minska cmdlet-prestanda.
Om du inte använder den här parametern visar cmdleten en varning. Om du vill inaktivera den här varningen anger du $CMPSSuppressFastNotUsedCheck = $true .
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Ange ett konfigurationsprincipobjekt för att hämta dess distributioner. Hämta det här objektet med hjälp av cmdleten 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
Ange namnet på en konfigurationsprincip för att hämta dess distributioner.
Type: String
Parameter Sets: SearchByName
Aliases: ConfigurationPolicyName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-SmsObjectId
Ange ID för en konfigurationsprincip för att hämta dess distributioner.
Type: Int32
Parameter Sets: SearchById
Aliases: CI_ID, ConfigurationPolicyID
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Sammanfattning
Lägg till den här parametern för att SMS_DeploymentSummary WMI-klassobjektet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
IResultObject[]#SMS_DeploymentSummary
IResultObject#SMS_DeploymentSummary
IResultObject[]#SMS_ConfigurationPolicyAssignment
IResultObject#SMS_ConfigurationPolicyAssignment
ANTECKNINGAR
RELATED LINKS
New-CMConfigurationPolicyDeployment
Remove-CMConfigurationPolicyDeployment