Delen via


Start-CMDistributionPointUpgrade

SYNOPSIS

Een upgrade uitvoeren voor een gedeeld distributiepunt.

SYNTAX

UseImportCertificate (standaard)

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

De cmdlet Start-CMDistributionPointUpgrade upgradet een gedeeld distributiepunt naar een Configuration Manager-distributiepunt.

Wanneer u migreert van een Configuration Manager 2007-bronhiërarchie, kunt u een gedeeld distributiepunt upgraden om er een Configuration Manager maken. U kunt distributiepunten updaten op zowel primaire als secundaire sites. Het upgradeproces verwijdert het distributiepunt uit de Configuration Manager 2007-hiërarchie en maakt er een sitesysteemserver van in de Configuration Manager hiërarchie. Dit proces kopieert ook de bestaande inhoud, die zich op het distributiepunt bevindt, naar een nieuwe locatie op de computer voor distributiepunten. Het upgradeproces wijzigt vervolgens de kopie van de inhoud om de Configuration Manager single instance store te maken voor gebruik met Configuration Manager implementatie van inhoud. Daarom hoeft u bij het upgraden van een distributiepunt gemigreerde inhoud die werd gehost op het Configuration Manager 2007, niet opnieuw te distribueren.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: Een gedeeld distributiepunt upgraden

Met de eerste opdracht wordt het distributiepuntobject met de id 6617708D-0F98-4898-8D05-9E882C23DCB2 opgeslagen en wordt het object opgeslagen in de variabele $CIObj.

Met de tweede opdracht wordt het gedeelde distributiepunt dat is opgeslagen in $CIObj naar de Configuration Manager site met de sitecode CM1. De opdracht geeft het importpad op voor het door PKI uitgegeven certificaat dat door het distributiepunt wordt gebruikt en geeft aan dat de inhoud van het distributiepunt vooraf kan worden faseerd.

$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

Geeft aan of clients een terugvalbronlocatie voor inhoud kunnen gebruiken.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowPreStaging

Geeft aan of het distributiepunt inhoud vooraf kan faseeren.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowRespondIncomingPxeRequest

Geeft aan of het distributiepunt kan reageren op PXE-aanvragen (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

Hiermee geeft u de datum en tijd waarop het certificaat verloopt.

Type: DateTime
Parameter Sets: UseSelfSignedCertificate
Aliases:

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

-CertificatePassword

Hiermee geeft u het wachtwoord op als een beveiligde tekenreeks voor het PKI-clientcertificaat (Public Key Infrastructure) voor het distributiepunt.

Type: SecureString
Parameter Sets: UseImportCertificate
Aliases:

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

-CertificatePath

Hiermee geeft u het importpad op voor het door PKI uitgegeven certificaat dat door het distributiepunt wordt gebruikt.

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

Hiermee geeft u het verbindingstype van de client op. Geldige waarden zijn:

  • Internet
  • InternetAndIntranet
  • Intranet
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

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

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

-ContentValidationPriority

Hiermee geeft u de prioriteit voor inhoudsvalidatie op. Geldige waarden zijn:

  • Hoog
  • Hoogste
  • Beperkt
  • Laagste
  • Normaal

De standaardwaarde is Laagste.

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

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-EnableAnonymous

Geeft aan of het distributiepunt anonieme verbindingen van Configuration Manager clients naar de inhoudsbibliotheek toestaat.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-EnableNonWdsPxe

Geeft aan of de Configuration Manager PXE-responder is ingeschakeld op het distributiepunt. Wanneer u een PXE-responder zonder Windows Deployment Service (WDS) inschakelen, installeert Configuration Manager de PXE-responderservice op het distributiepunt.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-EnablePxeSupport

Geeft aan of PXE op het distributiepunt moet worden ingeschakeld.

Wanneer u PXE inschakelen, Configuration Manager installeert Windows Deployment Services op de server, indien nodig. Windows Deployment Service is de service die de PXE-opstartprocedure uitvoert voor het installeren van besturingssystemen. Nadat u het distributiepunt hebt gemaakt, Configuration Manager een provider in Windows Deployment Services die gebruikmaakt van de PXE-opstartfuncties.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-EnableUnknownComputerSupport

Geeft aan of ondersteuning voor onbekende computers is ingeschakeld. Onbekende computers zijn computers die niet worden beheerd door Configuration Manager.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ForceWhenDuplicateCertificate

Geeft aan of Configuration Manager een dubbel certificaat overschrijft wanneer u een PKI-clientcertificaat voor het distributiepunt importeert.

Type: Boolean
Parameter Sets: UseImportCertificate
Aliases:

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

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InitiateConnection

Geeft aan of het distributiepunt de verbinding met de clients initieert.

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

Hiermee geeft u een sitesysteeminstallatieaccount op. Configuration Manager 2007 Site Component Manager-service sitesysteeminstallatieaccounts gebruikt om sitesystemen te installeren, opnieuw te installeren, te verwijderen en te configureren.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-MacAddressForRespondingPxeRequest

Hiermee geeft u een matrix van MAC-adressen (Media Access Controller) op die het distributiepunt gebruikt om te reageren op PXE-aanvragen (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

Hiermee geeft u de hoeveelheid vrije ruimte op een station voordat Configuration Manager een ander station kiest en gaat het kopieerproces naar dat station. Inhoudsbestanden kunnen meerdere stations omvatten.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-PathForSavingMigratedPackage

Hiermee geeft u het pad op voor een kopie van de gemigreerde inhoud.

Type: String
Parameter Sets: (All)
Aliases:

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

-PrimaryContentLibraryLocation

Hiermee geeft u de primaire inhoudslocatie. Configuration Manager kopieert inhoud naar de primaire inhoudslocatie totdat de hoeveelheid vrije ruimte de waarde bereikt die u hebt opgegeven voor de parameter MinFreeSpaceMB. Geldige waarden zijn:

  • Automatisch.
  • Station letter van A: tot en met 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

Hiermee geeft u de locatie van de primaire pakket share. Configuration Manager kopieert inhoud naar de locatie van de primaire pakket-share totdat de hoeveelheid vrije ruimte de waarde bereikt die u hebt opgegeven voor de parameter MinFreeSpaceMB. Geldige waarden zijn:

  • Automatisch.
  • Station letter van A: tot en met 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

Hiermee geeft u de FQDN (Fully Qualified Domain Name) op van de sitesysteemserver die als host voor het distributiepunt wordt gebruikt.

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

Hiermee geeft u de locatie van de secundaire inhoud. Geldige waarden zijn:

  • Automatisch.
  • Station letter from A: through 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

Hiermee geeft u de locatie van de secundaire pakket-share. Geldige waarden zijn:

  • Automatisch.
  • Station letter from A: through 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

Geef op hoe het distributiepunt gebruikers koppelt aan de doelcomputer voor PXE-implementaties. Geldige waarden zijn:

  • 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

Hiermee geeft u een CMSchedule-object. Een CMSchedule-object definieert de planning voor het valideren van de integriteit van inhoudsbestanden op het distributiepunt. Als u een CMSchedule-object wilt maken, gebruikt u de cmdlet New-CMSchedule.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

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

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

OPMERKINGEN

Get-CMDistributionPointGroup

Get-CMBoundaryGroup

Get-CMDistributionPoint

New-CMSchedule