Dela via


Set-CMClientPushInstallation

SYNOPSIS

Konfigurera inställningar för push-installation av klienter.

SYNTAX

SearchByValueMandatory (standard)

Set-CMClientPushInstallation [-AddAccount <String[]>] [-AllownNTLMFallback <Boolean>]
 [-ChosenAccount <String[]>] [-ClearAccount] [-EnableAutomaticClientPushInstallation <Boolean>]
 [-EnableSystemTypeConfigurationManager <Boolean>] [-EnableSystemTypeServer <Boolean>]
 [-EnableSystemTypeWorkstation <Boolean>] -InputObject <IResultObject> [-InstallationProperty <String>]
 [-InstallClientToDomainController <Boolean>] [-RemoveAccount <String[]>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByComponentValueMandatory

Set-CMClientPushInstallation [-AddAccount <String[]>] [-AllownNTLMFallback <Boolean>]
 [-ChosenAccount <String[]>] [-ClearAccount] [-EnableAutomaticClientPushInstallation <Boolean>]
 [-EnableSystemTypeConfigurationManager <Boolean>] [-EnableSystemTypeServer <Boolean>]
 [-EnableSystemTypeWorkstation <Boolean>] -InputObject <IResultObject> [-InstallationProperty <String>]
 [-InstallClientToDomainController <Boolean>] [-RemoveAccount <String[]>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByNameMandatory

Set-CMClientPushInstallation [-AddAccount <String[]>] [-AllownNTLMFallback <Boolean>]
 [-ChosenAccount <String[]>] [-ClearAccount] [-EnableAutomaticClientPushInstallation <Boolean>]
 [-EnableSystemTypeConfigurationManager <Boolean>] [-EnableSystemTypeServer <Boolean>]
 [-EnableSystemTypeWorkstation <Boolean>] [-InstallationProperty <String>]
 [-InstallClientToDomainController <Boolean>] -Name <String> [-RemoveAccount <String[]>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchBySiteCodeMandatory

Set-CMClientPushInstallation [-AddAccount <String[]>] [-AllownNTLMFallback <Boolean>]
 [-ChosenAccount <String[]>] [-ClearAccount] [-EnableAutomaticClientPushInstallation <Boolean>]
 [-EnableSystemTypeConfigurationManager <Boolean>] [-EnableSystemTypeServer <Boolean>]
 [-EnableSystemTypeWorkstation <Boolean>] [-InstallationProperty <String>]
 [-InstallClientToDomainController <Boolean>] [-RemoveAccount <String[]>] [-SiteCode <String>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Använd den här cmdleten för att ändra platskonfigurationen för push-installation av klienter. Push-installationsmetoden för klienten installerar Konfigurationshanteraren klienten på datorer som platsen identifierar.

Du kan också starta en push-installation av klienter genom att köra guiden Push-installation av klienter för en specifik samling eller resurs i en samling.

Mer information finns i Installera klienter på Windows-baserade datorer i Konfigurationshanteraren.

Anteckning

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

EXAMPLES

Exempel 1: Ändra inställningarna för en push-installation av en klient

Det här kommandot gör följande konfigurationer:

  • Använd automatiskt push-meddelanden för identifierade datorer.
  • Push-skicka klienten till platssystemservrar
  • Platsen använder kontot contoso\svc_smspush för att ansluta till datorn för att installera klientprogramvaran.

Parametern InstallationProperty anger värdet för egenskapen SMSSITECODE för Windows Installer-paketet till CM1. Den här inställningen tilldelar klienten till den plats som har platskoden CM1.

Set-CMClientPushInstallation -SiteCode "CM1" -EnableAutomaticClientPushInstallation $True -EnableSystemTypeConfiguationManager $True -ChosenAccount "contoso\svc_smspush" -InstallationProperty "SMSSITECODE=CM1"

PARAMETERS

-AddAccount

Ange en strängmatris för ett eller flera konton som kan installera klienten. Kontona måste vara en lokal administratör på måldatorn. För varje konto använder du formatet domain\username .

Mer information finns i Kontot för push-installation av klienter.

Type: String[]
Parameter Sets: (All)
Aliases: AddAccounts

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

-AllownNTLMFallback

Om den här parametern $true försöker den ansluta igen med hjälp av NTLM om platsen inte kan autentisera klienten med hjälp av Kerberos. Den rekommenderade konfigurationen för förbättrad säkerhet är att ange den här parametern till $false, vilket kräver Kerberos utan NTLM-återställning.

Anteckning

När den använder push-installation av Konfigurationshanteraren-klienten skapar platsservern en fjärranslutning till klienten. Platsen kan kräva ömsesidig Kerberos-autentisering genom att inte tillåta återställning till NTLM innan anslutningen upprättas. Det här beteendet hjälper till att skydda kommunikationen mellan servern och klienten.

Beroende på dina säkerhetsprinciper kanske din miljö redan föredrar eller kräver Kerberos framför den äldre NTLM-autentiseringen. Mer information om säkerhetsöverväganden för dessa autentiseringsprotokoll finns i Windows säkerhetsprincipinställningen för att begränsa NTLM.

Om du vill använda den här funktionen måste klienterna finnas i en betrodd Active Directory-skog. Kerberos i Windows förlitar sig på Active Directory för ömsesidig autentisering.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ChosenAccount

Ange en strängmatris för ett eller flera konton som redan har lagts till i Konfigurationshanteraren.

Type: String[]
Parameter Sets: (All)
Aliases: ChosenAccounts

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

-ClearAccount

Lägg till den här parametern för att ta bort alla konton som för närvarande har angetts för klient-push på platsen. Om du vill ta bort ett enskilt konto använder du parametern RemoveAccount.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: ClearAccounts

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: False
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

-EnableAutomaticClientPushInstallation

Ange den här parametern $true att installera Konfigurationshanteraren på nyligen identifierade datorresurser. Det möjliggör även installation på befintliga datorresurser som inte har -klienten installerad.

Om du anger den här parametern $false kan du fortfarande använda åtgärden Installera klient på en samling eller enhet.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-EnableSystemTypeConfigurationManager

Ange den här parametern $true att installera Konfigurationshanteraren på platssystemservrar.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-EnableSystemTypeServer

Ange den här parametern $true att installera Konfigurationshanteraren på servrar.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-EnableSystemTypeWorkstation

Ange den här parametern $true att installera Konfigurationshanteraren på arbetsstationer.

Type: Boolean
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 objekt för push-installation av klienter. Hämta det här objektet med hjälp av cmdleten Get-CMClientPushInstallation.

Type: IResultObject
Parameter Sets: SearchByValueMandatory, SearchByComponentValueMandatory
Aliases: ClientPushComponent

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

-InstallClientToDomainController

Ange den här parametern för att ange om Konfigurationshanteraren ska installeras på domänkontrollanter:

  • $true: Installera alltid klienten på domänkontrollanter.
  • $false: Installera aldrig klienten på domänkontrollanter, såvida det inte anges i guiden Push-installation av klienter.
Type: Boolean
Parameter Sets: (All)
Aliases:

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

-InstallationEgenskaper

Ange eventuella installationsegenskaper som ska användas när du installerar Konfigurationshanteraren klienten.

Ett exempel:

/mp:mp01.contoso.com CCMDEBUGLOGGING="1" CCMLOGGINGENABLED="TRUE" CCMLOGLEVEL="0" CCMLOGMAXHISTORY="5" CCMLOGMAXSIZE="10000000" SMSCACHESIZE="15000" SMSSITECODE="XYZ" SMSMP=mp01.contoso.com

Mer information finns i Om klientinstallationsparametrar och -egenskaper i Konfigurationshanteraren.

Type: String
Parameter Sets: (All)
Aliases:

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

-Name

Anger ett namn för push-installationen av klienten.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases: SiteName

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

-RemoveAccount

Ange en strängmatris med konton för push-installation av klienter som ska tas bort. Om du vill ta bort alla konton använder du parametern ClearAccount.

Type: String[]
Parameter Sets: (All)
Aliases: RemoveAccounts

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

-SiteCode

Ange platskoden med tre tecken. Till exempel XYZ.

Type: String
Parameter Sets: SearchBySiteCodeMandatory
Aliases:

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: False
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

ANTECKNINGAR

Get-CMClientPushInstallation

Installera klienter på Windows-baserade datorer i Konfigurationshanteraren