Start-CMDistributionPointUpgrade

Aktualisiert einen freigegebenen Verteilungspunkt.

Syntax

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>]
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>]

Beschreibung

Das Cmdlet Start-CMDistributionPointUpgrade aktualisiert einen freigegebenen Verteilungspunkt auf einen Configuration Manager Verteilungspunkt.

Wenn Sie von einer Configuration Manager 2007-Quellhierarchie migrieren, können Sie einen freigegebenen Verteilungspunkt aktualisieren, um ihn zu einem Configuration Manager Verteilungspunkt zu machen. Sie können Verteilungspunkte sowohl an primären als auch an sekundären Standorten aktualisieren. Der Upgradeprozess entfernt den Verteilungspunkt aus der Configuration Manager 2007-Hierarchie und macht ihn zu einem Standortsystemserver in der Configuration Manager Hierarchie. Dieser Prozess kopiert auch den vorhandenen Inhalt, der sich auf dem Verteilungspunkt befindet, an einen neuen Speicherort auf dem Verteilungspunktcomputer. Der Upgradeprozess ändert dann die Kopie des Inhalts, um den Configuration Manager einzelnen Instanzspeicher für die Verwendung mit Configuration Manager Inhaltsbereitstellung zu erstellen. Daher müssen Sie beim Upgrade eines Verteilungspunkts keine migrierten Inhalte neu verteilen, die auf dem Configuration Manager 2007-Verteilungspunkt gehostet wurden.

Hinweis

Führen Sie Configuration Manager Cmdlets auf dem Configuration Manager-Websitelaufwerk aus, z. PS XYZ:\>B. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Upgrade eines freigegebenen Verteilungspunkts

Der erste Befehl ruft das Verteilungspunktobjekt mit der ID 6617708D-0F98-4898-8D05-9E882C23DCB2 ab und speichert das Objekt in der variablen $CIObj.

Der zweite Befehl aktualisiert den in $CIObj gespeicherten freigegebenen Verteilungspunkt auf den Configuration Manager Standort mit dem Standortcode CM1. Der Befehl gibt den Importpfad für das von der PKI ausgestellte Zertifikat an, das vom Verteilungspunkt verwendet wird, und gibt an, dass der Verteilungspunkt Inhalte vorstufen kann.

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

Parameter

-AllowFallbackForContent

Gibt an, ob Clients einen Fallbackquellspeicherort für Inhalte verwenden können.

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

-AllowPreStaging

Gibt an, ob der Verteilungspunkt Inhalte vorstufen kann.

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

-AllowRespondIncomingPxeRequest

Gibt an, ob der Verteilungspunkt auf PXE-Anforderungen (Pre-Boot Execution Environment) reagieren kann.

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

-CertificateExpirationTimeUtc

Gibt das Datum und die Uhrzeit des Ablaufs des Zertifikats an.

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

-CertificatePassword

Gibt das Kennwort als sichere Zeichenfolge für das PKI-Clientzertifikat (Public Key Infrastructure) für den Verteilungspunkt an.

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

-CertificatePath

Gibt den Importpfad für das von der PKI ausgestellte Zertifikat an, das vom Verteilungspunkt verwendet wird.

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

-ClientCommunicationMode

Type:ComputerCommunicationType
Accepted values:Http, Https
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClientConnectionType

Gibt den Clientverbindungstyp an. Gültige Werte sind:

  • Internet
  • InternetAndIntranet
  • Intranet
Type:ClientConnectionTypes
Accepted values:Intranet, Internet, InternetAndIntranet
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContentValidationPriority

Gibt die Priorität der Inhaltsüberprüfung an. Gültige Werte sind:

  • Hoch
  • Highest
  • Niedrig
  • Lowest
  • Mittel

Der Standardwert ist Niedrigste.

Type:Priority
Accepted values:Lowest, Low, Medium, High, Highest
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DestinationSiteCode

Type:String
Aliases:SiteCode
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

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

-EnableAnonymous

Gibt an, ob der Verteilungspunkt anonyme Verbindungen zwischen Configuration Manager Clients und der Inhaltsbibliothek zulässt.

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

-EnableNonWdsPxe

Gibt an, ob der Configuration Manager PXE-Antwortdienst auf dem Verteilungspunkt aktiviert ist. Wenn Sie einen PXE-Antwortdienst ohne Windows-Bereitstellungsdienst (Windows Deployment Service, WDS) aktivieren, installiert Configuration Manager seinen PXE-Antwortdienst auf dem Verteilungspunkt.

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

-EnablePxeSupport

Gibt an, ob PXE auf dem Verteilungspunkt aktiviert werden soll.

Wenn Sie PXE aktivieren, installiert Configuration Manager bei Bedarf Die Windows-Bereitstellungsdienste auf dem Server. Der Windows-Bereitstellungsdienst ist der Dienst, der den PXE-Start ausführt, um Betriebssysteme zu installieren. Nachdem Sie den Verteilungspunkt erstellt haben, installiert Configuration Manager einen Anbieter in den Windows-Bereitstellungsdiensten, der die PXE-Startfunktionen verwendet.

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

-EnableUnknownComputerSupport

Gibt an, ob die Unterstützung für unbekannte Computer aktiviert ist. Unbekannte Computer sind Computer, die nicht von Configuration Manager verwaltet werden.

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

-ForceWhenDuplicateCertificate

Gibt an, ob Configuration Manager beim Importieren eines PKI-Clientzertifikats für den Verteilungspunkt ein doppeltes Zertifikat überschreibt.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

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

-InitiateConnection

Gibt an, ob der Verteilungspunkt die Verbindung mit den Clients initiiert.

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

-InputObject

Type:IResultObject
Aliases:SharedDistributionPoint
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InstallationAccount

Gibt ein Standortsysteminstallationskonto an. Configuration Manager 2007 Standortkomponenten-Manager-Dienst verwendet Standortsysteminstallationskonten, um Standortsysteme zu installieren, neu zu installieren, zu deinstallieren und zu konfigurieren.

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

-InstallIis

Type:Boolean
Aliases:InstallInternetServer
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MacAddressForRespondingPxeRequest

Gibt ein Array von MAC-Adressen (Media Access Controller) an, die der Verteilungspunkt verwendet, um auf PXE-Anforderungen (Pre-Boot Execution Environment) zu reagieren.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinFreeSpaceMB

Gibt die Menge an freiem Speicherplatz auf einem Laufwerk an, bevor Configuration Manager ein anderes Laufwerk wählt und den Kopiervorgang auf dieses Laufwerk fortsetzt. Inhaltsdateien können mehrere Laufwerke umfassen.

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

-PathForSavingMigratedPackage

Gibt den Pfad für eine Kopie des migrierten Inhalts an.

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

-PrimaryContentLibraryLocation

Gibt den primären Inhaltsspeicherort an. Configuration Manager Inhalt an den primären Inhaltsspeicherort kopiert, bis die Menge des freien Speicherplatzes den Wert erreicht, den Sie für den MinFreeSpaceMB-Parameter angegeben haben. Gültige Werte sind:

  • Automatisch.
  • Laufwerkbuchstabe von A: bis Z:.
Type:DriveType
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
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrimaryPackageShareLocation

Gibt den speicherort der primären Paketfreigabe an. Configuration Manager Inhalt in den primären Paketfreigabespeicherort kopiert, bis die Menge des freien Speicherplatzes den Wert erreicht, den Sie für den MinFreeSpaceMB-Parameter angegeben haben. Gültige Werte sind:

  • Automatisch.
  • Laufwerkbuchstabe von A: bis Z:.
Type:DriveType
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
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublicFqdn

Gibt den vollqualifizierten Domänennamen (FQDN) des Standortsystemservers an, auf dem der Verteilungspunkt gehostet wird.

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

-PxePassword

Type:SecureString
Aliases:ComputersUsePxePassword
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PxeServerResponseDelaySec

Type:Int32
Aliases:PxeServerResponseDelaySeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SecondaryContentLibraryLocation

Gibt den sekundären Inhaltsspeicherort an. Gültige Werte sind:

  • Automatisch.
  • Laufwerkbuchstabe von A: bis Z:.
Type:DriveType
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
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SecondaryPackageShareLocation

Gibt den Speicherort der sekundären Paketfreigabe an. Gültige Werte sind:

  • Automatisch.
  • Laufwerkbuchstabe von A: bis Z:.
Type:DriveType
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
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserDeviceAffinity

Geben Sie an, wie der Verteilungspunkt Benutzer dem Zielcomputer für PXE-Bereitstellungen zuordnet. Gültige Werte sind:

  • AllowWithAutomaticApproval
  • AllowWithManualApproval
  • DoNotUse
Type:UserDeviceAffinityType
Accepted values:DoNotUse, AllowWithManualApproval, AllowWithAutomaticApproval
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ValidateContentSchedule

Gibt ein CMSchedule-Objekt an. Ein CMSchedule-Objekt definiert den Zeitplan für die Überprüfung der Integrität von Inhaltsdateien auf dem Verteilungspunkt. Verwenden Sie zum Erstellen eines CMSchedule-Objekts das Cmdlet New-CMSchedule .

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

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject