Partager via


Start-CMDistributionPointUpgrade

Met à niveau un point de distribution partagé.

Syntaxe

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

Description

L’applet de commande Start-CMDistributionPointUpgrade met à niveau un point de distribution partagé vers un point de distribution Configuration Manager.

Lorsque vous migrez à partir d’une hiérarchie source Configuration Manager 2007, vous pouvez mettre à niveau un point de distribution partagé pour en faire un point de distribution Configuration Manager. Vous pouvez mettre à niveau les points de distribution sur les sites principaux et secondaires. Le processus de mise à niveau supprime le point de distribution de la hiérarchie Configuration Manager 2007 et en fait un serveur de système de site dans la hiérarchie Configuration Manager. Ce processus copie également le contenu existant qui se trouve sur le point de distribution vers un nouvel emplacement sur l’ordinateur du point de distribution. Le processus de mise à niveau modifie ensuite la copie du contenu pour créer l’Configuration Manager magasin d’instances unique à utiliser avec Configuration Manager déploiement de contenu. Par conséquent, lorsque vous mettez à niveau un point de distribution, vous n’avez pas besoin de redistribuer le contenu migré qui a été hébergé sur le point de distribution Configuration Manager 2007.

Remarque

Exécutez Configuration Manager applets de commande à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Mettre à niveau un point de distribution partagé

La première commande obtient l’objet de point de distribution qui a l’ID 6617708D-0F98-4898-8D05-9E882C23DCB2 et stocke l’objet dans la variable $CIObj.

La deuxième commande met à niveau le point de distribution partagé stocké dans $CIObj vers le site Configuration Manager dont le code de site est CM1. La commande spécifie le chemin d’importation du certificat émis par l’infrastructure à clé publique que le point de distribution utilise, et spécifie que le point de distribution peut préphaser le contenu.

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

Paramètres

-AllowFallbackForContent

Indique si les clients peuvent utiliser un emplacement source de secours pour le contenu.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AllowPreStaging

Indique si le point de distribution peut préphaser le contenu.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AllowRespondIncomingPxeRequest

Indique si le point de distribution peut répondre aux requêtes PXE (Pre-Boot Execution Environment).

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CertificateExpirationTimeUtc

Spécifie la date et l’heure d’expiration du certificat.

Type:DateTime
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CertificatePassword

Spécifie le mot de passe, sous forme de chaîne sécurisée, pour le certificat client d’infrastructure à clé publique (PKI) pour le point de distribution.

Type:SecureString
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CertificatePath

Spécifie le chemin d’importation du certificat émis par l’infrastructure à clé publique que le point de distribution utilise.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ClientCommunicationMode

Type:ComputerCommunicationType
Valeurs acceptées:Http, Https
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ClientConnectionType

Spécifie le type de connexion client. Les valeurs valides sont les suivantes :

  • Internet
  • InternetAndIntranet
  • Intranet
Type:ClientConnectionTypes
Valeurs acceptées:Intranet, Internet, InternetAndIntranet
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ContentValidationPriority

Spécifie la priorité de validation du contenu. Les valeurs valides sont les suivantes :

  • Élevé
  • La plus élevée
  • Faible
  • La plus faible
  • Moyen

La valeur par défaut est La plus basse.

Type:Priority
Valeurs acceptées:Lowest, Low, Medium, High, Highest
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DestinationSiteCode

Type:String
Alias:SiteCode
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableAnonymous

Indique si le point de distribution autorise les connexions anonymes entre Configuration Manager clients et la bibliothèque de contenu.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableNonWdsPxe

Indique si le répondeur PXE Configuration Manager est activé sur le point de distribution. Lorsque vous activez un répondeur PXE sans le service de déploiement Windows (WDS), Configuration Manager installe son service de répondeur PXE sur le point de distribution.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnablePxeSupport

Indique s’il faut activer PXE sur le point de distribution.

Lorsque vous activez PXE, Configuration Manager installe les services de déploiement Windows sur le serveur, si nécessaire. Le service de déploiement Windows est le service qui effectue le démarrage PXE pour installer les systèmes d’exploitation. Après avoir créé le point de distribution, Configuration Manager installe un fournisseur dans les services de déploiement Windows qui utilise les fonctions de démarrage PXE.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableUnknownComputerSupport

Indique si la prise en charge des ordinateurs inconnus est activée. Les ordinateurs inconnus sont des ordinateurs qui ne sont pas gérés par Configuration Manager.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWhenDuplicateCertificate

Indique si Configuration Manager remplace un certificat en double lorsque vous importez un certificat client PKI pour le point de distribution.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InitiateConnection

Indique si le point de distribution lance la connexion avec les clients.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Type:IResultObject
Alias:SharedDistributionPoint
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-InstallationAccount

Spécifie un compte d’installation de système de site. Configuration Manager 2007 Gestionnaire de composant de site service utilise des comptes d’installation de système de site pour installer, réinstaller, désinstaller et configurer des systèmes de site.

Type:IResultObject
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InstallIis

Type:Boolean
Alias:InstallInternetServer
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MacAddressForRespondingPxeRequest

Spécifie un tableau d’adresses MAC (Media Access Controller) que le point de distribution utilise pour répondre aux demandes PXE (Pre-Boot Execution Environment).

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MinFreeSpaceMB

Spécifie la quantité d’espace libre sur un lecteur avant Configuration Manager choisit un autre lecteur et poursuit le processus de copie sur ce lecteur. Les fichiers de contenu peuvent s’étendre sur plusieurs lecteurs.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PathForSavingMigratedPackage

Spécifie le chemin d’accès d’une copie du contenu migré.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PrimaryContentLibraryLocation

Spécifie l’emplacement de contenu principal. Configuration Manager copie le contenu vers l’emplacement de contenu principal jusqu’à ce que la quantité d’espace libre atteigne la valeur que vous avez spécifiée pour le paramètre MinFreeSpaceMB. Les valeurs valides sont les suivantes :

  • Automatique.
  • Lettre de lecteur de A: à Z:.
Type:DriveType
Valeurs acceptées: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PrimaryPackageShareLocation

Spécifie l’emplacement du partage de package principal. Configuration Manager copie le contenu vers l’emplacement de partage de package principal jusqu’à ce que la quantité d’espace libre atteigne la valeur que vous avez spécifiée pour le paramètre MinFreeSpaceMB. Les valeurs valides sont les suivantes :

  • Automatique.
  • Lettre de lecteur de A: à Z:.
Type:DriveType
Valeurs acceptées: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PublicFqdn

Spécifie le nom de domaine complet (FQDN) du serveur de système de site qui héberge le point de distribution.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PxePassword

Type:SecureString
Alias:ComputersUsePxePassword
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PxeServerResponseDelaySec

Type:Int32
Alias:PxeServerResponseDelaySeconds
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SecondaryContentLibraryLocation

Spécifie l’emplacement du contenu secondaire. Les valeurs valides sont les suivantes :

  • Automatique.
  • Lettre de lecteur de A: à Z:.
Type:DriveType
Valeurs acceptées: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SecondaryPackageShareLocation

Spécifie l’emplacement du partage de package secondaire. Les valeurs valides sont les suivantes :

  • Automatique.
  • Lettre de lecteur de A: à Z:.
Type:DriveType
Valeurs acceptées: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UserDeviceAffinity

Spécifiez comment le point de distribution associe les utilisateurs à l’ordinateur de destination pour les déploiements PXE. Les valeurs valides sont les suivantes :

  • AllowWithAutomaticApproval
  • AllowWithManualApproval
  • DoNotUse
Type:UserDeviceAffinityType
Valeurs acceptées:DoNotUse, AllowWithManualApproval, AllowWithAutomaticApproval
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ValidateContentSchedule

Spécifie un objet CMSchedule. Un objet CMSchedule définit la planification de validation de l’intégrité des fichiers de contenu sur le point de distribution. Pour créer un objet CMSchedule, utilisez l’applet de commande New-CMSchedule .

Type:IResultObject
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject