Dela via


Start-CMDistributionPointUpgrade

SYNOPSIS

Uppgraderar en delad distributionsplats.

SYNTAX

UseImportCertificate (standard)

Start-CMDistributionPointUpgrade [-AllowFallbackForContent <Boolean>] [-AllowPreStaging <Boolean>]
 [-AllowRespondIncomingPxeRequest <Boolean>] [-CertificatePassword <SecureString>] -CertificatePath <String>
 [-ClientCommunicationMode <ComputerCommunicationType>] [-ClientConnectionType <ClientConnectionTypes>]
 [-ContentValidationPriority <Priority>] -DestinationSiteCode <String> [-EnableAnonymous <Boolean>]
 [-EnableNonWdsPxe <Boolean>] [-EnablePxeSupport <Boolean>] [-EnableUnknownComputerSupport <Boolean>]
 [-ForceWhenDuplicateCertificate <Boolean>] [-InitiateConnection <Boolean>] -InputObject <IResultObject>
 [-InstallationAccount <IResultObject>] [-InstallIis <Boolean>] [-MacAddressForRespondingPxeRequest <String[]>]
 [-MinFreeSpaceMB <Int32>] [-PathForSavingMigratedPackage <String>]
 [-PrimaryContentLibraryLocation <DriveType>] [-PrimaryPackageShareLocation <DriveType>] [-PublicFqdn <String>]
 [-PxePassword <SecureString>] [-PxeServerResponseDelaySec <Int32>]
 [-SecondaryContentLibraryLocation <DriveType>] [-SecondaryPackageShareLocation <DriveType>]
 [-UserDeviceAffinity <UserDeviceAffinityType>] [-ValidateContentSchedule <IResultObject>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

UseSelfSignedCertificate

Start-CMDistributionPointUpgrade [-AllowFallbackForContent <Boolean>] [-AllowPreStaging <Boolean>]
 [-AllowRespondIncomingPxeRequest <Boolean>] -CertificateExpirationTimeUtc <DateTime>
 [-ClientCommunicationMode <ComputerCommunicationType>] [-ClientConnectionType <ClientConnectionTypes>]
 [-ContentValidationPriority <Priority>] -DestinationSiteCode <String> [-EnableAnonymous <Boolean>]
 [-EnableNonWdsPxe <Boolean>] [-EnablePxeSupport <Boolean>] [-EnableUnknownComputerSupport <Boolean>]
 [-InitiateConnection <Boolean>] -InputObject <IResultObject> [-InstallationAccount <IResultObject>]
 [-InstallIis <Boolean>] [-MacAddressForRespondingPxeRequest <String[]>] [-MinFreeSpaceMB <Int32>]
 [-PathForSavingMigratedPackage <String>] [-PrimaryContentLibraryLocation <DriveType>]
 [-PrimaryPackageShareLocation <DriveType>] [-PublicFqdn <String>] [-PxePassword <SecureString>]
 [-PxeServerResponseDelaySec <Int32>] [-SecondaryContentLibraryLocation <DriveType>]
 [-SecondaryPackageShareLocation <DriveType>] [-UserDeviceAffinity <UserDeviceAffinityType>]
 [-ValidateContentSchedule <IResultObject>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
 [-Confirm] [<CommonParameters>]

DESCRIPTION

Cmdleten Start-CMDistributionPointUpgrade uppgraderar en delad distributionsplats till en Konfigurationshanteraren distributionsplats.

När du migrerar från en Konfigurationshanteraren 2007-källhierarki kan du uppgradera en delad distributionsplats så att den blir Konfigurationshanteraren en distributionsplats. Du kan uppgradera distributionsplatser på både primära och sekundära platser. Uppgraderingsprocessen tar bort distributionsplatsen från Konfigurationshanteraren 2007-hierarkin och gör den till en platssystemserver i Konfigurationshanteraren hierarkin. Den här processen kopierar också det befintliga innehållet på distributionsplatsen till en ny placering på distributionsplatsdatorn. Uppgraderingsprocessen ändrar sedan kopian av innehållet för att skapa Konfigurationshanteraren lagringsinstans för användning med Konfigurationshanteraren innehållsdistribution. När du uppgraderar en distributionsplats behöver du därför inte distribuera om migrerat innehåll som finns på Konfigurationshanteraren 2007-distributionsplatsen.

Anteckning

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

EXAMPLES

Exempel 1: Uppgradera en delad distributionsplats

Det första kommandot hämtar distributionsplatsens objekt som har ID 6617708D-0F98-4898-8D05-9E882C23DCB2 och lagrar objektet i $CIObj-variabeln.

Det andra kommandot uppgraderar den delade distributionsplatsen som lagras $CIObj till Konfigurationshanteraren plats som har platskoden CM1. Kommandot anger importsökvägen för det PKI-utfärdade certifikat som distributionsplatsen använder och anger att distributionsplatsen kan förinstallera innehåll.

$CIObj = Get-CMDistributionPoint -DistributionPointGroupId "{6617708D-0F98-4898-8D05-9E882C23DCB2}"
Start-CMDistributionPointUpgrade -AllowPreStaging $True -CertificatePath "\\Contoso01\CM\Toolbox\BaseCert.txt" -SharedDistributionPoint $CIObj -SiteCode "CM1"

PARAMETERS

-AllowFallbackForContent

Anger om klienter kan använda en återställningskälla för innehåll.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowPreStaging

Anger om distributionsplatsen kan förinstallera innehållet.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowRespondIncomingPxeRequest

Anger om distributionsplatsen kan svara på PXE-begäranden (Pre-Boot Execution Environment).

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-CertificateExpirationTimeUtc

Anger datum och tid när certifikatet upphör att gälla.

Type: DateTime
Parameter Sets: UseSelfSignedCertificate
Aliases:

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

-CertificatePassword

Anger lösenordet, som en säker sträng, för PKI-klientcertifikatet (Public Key Infrastructure) för distributionsplatsen.

Type: SecureString
Parameter Sets: UseImportCertificate
Aliases:

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

-CertificatePath

Anger importsökvägen för det PKI-utfärdade certifikatet som distributionsplatsen använder.

Type: String
Parameter Sets: UseImportCertificate
Aliases:

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

-ClientCommunicationMode

Type: ComputerCommunicationType
Parameter Sets: (All)
Aliases:
Accepted values: Http, Https

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

-ClientConnectionType

Anger klientanslutningstypen. Giltiga värden är:

  • Internet
  • InternetAndIntranet
  • Intranät
Type: ClientConnectionTypes
Parameter Sets: (All)
Aliases:
Accepted values: Intranet, Internet, InternetAndIntranet

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

-ContentValidationPriority

Anger prioriteten för innehållsvalidering. Giltiga värden är:

  • Högt
  • Högsta
  • Låg
  • Lägsta
  • Medel

Standardvärdet är Lägst.

Type: Priority
Parameter Sets: (All)
Aliases:
Accepted values: Lowest, Low, Medium, High, Highest

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

-DestinationSiteCode

Type: String
Parameter Sets: (All)
Aliases: SiteCode

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

-EnableAnonymous

Anger om distributionsplatsen tillåter anonyma anslutningar Konfigurationshanteraren klienter till innehållsbiblioteket.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-EnableNonWdsPxe

Anger om Konfigurationshanteraren PXE-svarare är aktiverad på distributionsplatsen. När du aktiverar en PXE-svarare utan Windows Deployment Service (WDS) Konfigurationshanteraren installerar Konfigurationshanteraren PXE-svarartjänsten på distributionsplatsen.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-EnablePxeSupport

Anger om du vill aktivera PXE på distributionsplatsen.

När du aktiverar PXE Konfigurationshanteraren installeras Windows Deployment Services på servern, om det behövs. Windows Deployment Services är den tjänst som utför PXE-starten för att installera operativsystem. När du har skapat distributionsplatsen Konfigurationshanteraren en provider i Windows Deployment Services som använder PXE-startfunktionerna.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-EnableUnknownComputerSupport

Anger om stöd för okända datorer är aktiverat. Okända datorer är datorer som inte hanteras av Konfigurationshanteraren.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ForceWhenDuplicateCertificate

Anger om Konfigurationshanteraren skriver över ett duplicerat certifikat när du importerar ett PKI-klientcertifikat för distributionsplatsen.

Type: Boolean
Parameter Sets: UseImportCertificate
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

-InitiateConnection

Anger om distributionsplatsen initierar anslutningen till klienterna.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-InputObject

Type: IResultObject
Parameter Sets: (All)
Aliases: SharedDistributionPoint

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

-InstallIis

Type: Boolean
Parameter Sets: (All)
Aliases: InstallInternetServer

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

-InstallationAccount

Anger ett konto för installation av platssystem. Konfigurationshanteraren 2007 Platskomponenthanteraren-tjänsten platssysteminstallationskonton för att installera, installera om, avinstallera och konfigurera platssystem.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-MacAddressForRespondingPxeRequest

Anger en matris med MAC-adresser (Media Access Controller) som distributionsplatsen använder för att svara på PXE-begäranden (Pre-Boot Execution Environment).

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

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

-MinFreeSpaceMB

Anger mängden ledigt utrymme på en enhet innan Konfigurationshanteraren väljer en annan enhet och fortsätter kopieringsprocessen till den enheten. Innehållsfiler kan omfatta flera enheter.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-PathForSavingMigratedPackage

Anger sökvägen till en kopia av det migrerade innehållet.

Type: String
Parameter Sets: (All)
Aliases:

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

-PrimaryContentLibraryLocation

Anger den primära innehållsplatsen. Konfigurationshanteraren kopierar innehåll till den primära innehållsplatsen tills mängden ledigt utrymme når det värde som du angav för parametern MinFreeSpaceMB. Giltiga värden är:

  • Automatisk.
  • Enhetsbeteckning från A: till Z:.
Type: DriveType
Parameter Sets: (All)
Aliases:
Accepted values: Automatic, A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z

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

-PrimaryPackageShareLocation

Anger den primära paketresursplatsen. Konfigurationshanteraren kopierar innehåll till den primära paketresursplatsen tills mängden ledigt utrymme når det värde som du angav för parametern MinFreeSpaceMB. Giltiga värden är:

  • Automatisk.
  • Enhetsbeteckning från A: till Z:.
Type: DriveType
Parameter Sets: (All)
Aliases:
Accepted values: Automatic, A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z

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

-PublicFqdn

Anger det fullständiga domännamnet (FQDN) för platssystemservern som är värd för distributionsplatsen.

Type: String
Parameter Sets: (All)
Aliases:

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

-PxePassword

Type: SecureString
Parameter Sets: (All)
Aliases: ComputersUsePxePassword

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

-PxeServerResponseDelaySec

Type: Int32
Parameter Sets: (All)
Aliases: PxeServerResponseDelaySeconds

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

-SecondaryContentLibraryLocation

Anger den sekundära innehållsplatsen. Giltiga värden är:

  • Automatisk.
  • Enhetsbeteckning från A: till Z:.
Type: DriveType
Parameter Sets: (All)
Aliases:
Accepted values: Automatic, A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z

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

-SecondaryPackageShareLocation

Anger den sekundära paketresursplatsen. Giltiga värden är:

  • Automatisk.
  • Enhetsbeteckning från A: till Z:.
Type: DriveType
Parameter Sets: (All)
Aliases:
Accepted values: Automatic, A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, Z

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

-UserDeviceAffinity

Ange hur distributionsplatsen associerar användare med måldatorn för PXE-distributioner. Giltiga värden är:

  • AllowWithAutomaticApproval
  • AllowWithManualApproval
  • DoNotUse
Type: UserDeviceAffinityType
Parameter Sets: (All)
Aliases:
Accepted values: DoNotUse, AllowWithManualApproval, AllowWithAutomaticApproval

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

-ValidateContentSchedule

Anger ett CMSchedule-objekt. Ett CMSchedule-objekt definierar schemat för att verifiera integriteten för innehållsfiler på distributionsplatsen. Om du vill skapa ett CMSchedule-objekt använder du cmdleten New-CMSchedule.

Type: IResultObject
Parameter Sets: (All)
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-CMDistributionPointGroup

Get-CMBoundaryGroup

Get-CMDistributionPoint

New-CMSchedule