Dela via


Get-CMClientSettingDeployment

SYNOPSIS

Hämta en distribution av ett objekt för anpassade klientinställningar.

SYNTAX

SearchByClientSettingName (standard)

Get-CMClientSettingDeployment -Name <String> [-Collection <IResultObject>] [-CollectionId <String>]
 [-CollectionName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]

SearchByClientSettingId

Get-CMClientSettingDeployment -Id <String> [-Collection <IResultObject>] [-CollectionId <String>]
 [-CollectionName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [<CommonParameters>]

SearchByClientSettingValue

Get-CMClientSettingDeployment -InputObject <IResultObject> [-Collection <IResultObject>]
 [-CollectionId <String>] [-CollectionName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling]
 [<CommonParameters>]

DESCRIPTION

Från och med version 2107 använder du den här cmdleten för att få en distribution av ett anpassat klientinställningsobjekt. Du kan använda det här objektet med Remove-CMClientSettingDeployment.

Mer information om klientinställningar finns i Så här konfigurerar du klientinställningar.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Hämta distributionen av en klientinställning efter namn

Det här exemplet hämtar först ett klientinställningsobjekt efter namn och skickar sedan objektet till Get-CMClientSettingDeployment för att visa information om distributionen.

$clientSetting =  Get-CMClientSetting -Name "Software Center customizations"
$clientSetting | Get-CMClientSettingDeployment

PARAMETERS

-Samling

Ange ett samlingsobjekt som klientinställningsobjektet ska distribueras till. 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 ID för en samling som klientinställningsobjektet distribueras till. Till exempel XYZ00012.

Type: String
Parameter Sets: (All)
Aliases:

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

-CollectionName

Ange namnet på en samling som klientinställningsobjektet distribueras till.

Type: String
Parameter Sets: (All)
Aliases:

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

-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

-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

-Id

Ange ID för det klientinställningsobjekt som distribueras. Inställnings-ID:t är ett heltalsvärde, 47 till exempel eller 16777225 .

Type: String
Parameter Sets: SearchByClientSettingId
Aliases: ClientSettingsId

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

-InputObject

Ange ett klientinställningsobjekt för att hämta dess distributioner. Hämta det här objektet med hjälp av cmdleten Get-CMClientSetting.

Type: IResultObject
Parameter Sets: SearchByClientSettingValue
Aliases: ClientSetting

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

-Name

Ange namnet på det klientinställningsobjekt som distribueras.

Type: String
Parameter Sets: SearchByClientSettingName
Aliases: ClientSettingsName

Required: True
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_ClientSettingsAssignment

IResultObject#SMS_ClientSettingsAssignment

ANTECKNINGAR

Mer information om det här returobjektet och dess egenskaper finns i SMS_ClientSettingsAssignment serverns WMI-klass.

New-CMClientSettingDeployment

Remove-CMClientSettingDeployment

Get-CMClientSetting

Skapa och distribuera anpassade klientinställningar