New-CMSecondarySite
Créez un site secondaire.
Syntaxe
New-CMSecondarySite
[-AllowFallbackForContent <Boolean>]
[-AllowPreStaging <Boolean>]
[-BoundaryGroup <IResultObject[]>]
-CertificateExpirationTimeUtc <DateTime>
[-ContentMonitoringPriority <Priority>]
[-CreateSelfSignedCertificate]
[-EnableAnonymous <Boolean>]
[-EnableBranchCache]
[-Http]
[-InstallationFolder <String>]
-InstallationSourceFile <IResultObject[]>
[-InstallInternetServer <Boolean>]
[-MinFreeSpaceMB <Int32>]
[-PrimaryContentLibraryLocation <DriveType>]
[-PrimaryPackageShareLocation <DriveType>]
[-PrimarySiteCode <String>]
[-SecondaryContentLibraryLocation <DriveType>]
[-SecondaryPackageShareLocation <DriveType>]
-SecondarySiteCode <String>
-ServerName <String>
-SiteName <String>
-SqlServerSetting <IResultObject[]>
[-ValidateContentSchedule <IResultObject>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMSecondarySite
[-AllowFallbackForContent <Boolean>]
[-AllowPreStaging <Boolean>]
[-BoundaryGroup <IResultObject[]>]
-CertificateExpirationTimeUtc <DateTime>
[-ClientConnectionType <ClientConnectionTypes>]
[-ContentMonitoringPriority <Priority>]
[-CreateSelfSignedCertificate]
[-EnableBranchCache]
[-Https]
[-InstallationFolder <String>]
-InstallationSourceFile <IResultObject[]>
[-InstallInternetServer <Boolean>]
[-MinFreeSpaceMB <Int32>]
[-PrimaryContentLibraryLocation <DriveType>]
[-PrimaryPackageShareLocation <DriveType>]
[-PrimarySiteCode <String>]
[-SecondaryContentLibraryLocation <DriveType>]
[-SecondaryPackageShareLocation <DriveType>]
-SecondarySiteCode <String>
-ServerName <String>
-SiteName <String>
-SqlServerSetting <IResultObject[]>
[-ValidateContentSchedule <IResultObject>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMSecondarySite
[-AllowFallbackForContent <Boolean>]
[-AllowPreStaging <Boolean>]
[-BoundaryGroup <IResultObject[]>]
-CertificatePassword <SecureString>
-CertificatePath <String>
[-ClientConnectionType <ClientConnectionTypes>]
[-ContentMonitoringPriority <Priority>]
[-EnableBranchCache]
[-ForceWhenDuplicateCertificate <Boolean>]
[-Https]
[-ImportCertificate]
[-InstallationFolder <String>]
-InstallationSourceFile <IResultObject[]>
[-InstallInternetServer <Boolean>]
[-MinFreeSpaceMB <Int32>]
[-PrimaryContentLibraryLocation <DriveType>]
[-PrimaryPackageShareLocation <DriveType>]
[-PrimarySiteCode <String>]
[-SecondaryContentLibraryLocation <DriveType>]
[-SecondaryPackageShareLocation <DriveType>]
-SecondarySiteCode <String>
-ServerName <String>
-SiteName <String>
-SqlServerSetting <IResultObject[]>
[-ValidateContentSchedule <IResultObject>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMSecondarySite
[-AllowFallbackForContent <Boolean>]
[-AllowPreStaging <Boolean>]
[-BoundaryGroup <IResultObject[]>]
-CertificatePassword <SecureString>
-CertificatePath <String>
[-ContentMonitoringPriority <Priority>]
[-EnableAnonymous <Boolean>]
[-EnableBranchCache]
[-ForceWhenDuplicateCertificate <Boolean>]
[-Http]
[-ImportCertificate]
[-InstallationFolder <String>]
-InstallationSourceFile <IResultObject[]>
[-InstallInternetServer <Boolean>]
[-MinFreeSpaceMB <Int32>]
[-PrimaryContentLibraryLocation <DriveType>]
[-PrimaryPackageShareLocation <DriveType>]
[-PrimarySiteCode <String>]
[-SecondaryContentLibraryLocation <DriveType>]
[-SecondaryPackageShareLocation <DriveType>]
-SecondarySiteCode <String>
-ServerName <String>
-SiteName <String>
-SqlServerSetting <IResultObject[]>
[-ValidateContentSchedule <IResultObject>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
L’applet de commande New-CMSecondarySite crée un site secondaire. Pour plus d’informations, consultez Préparer l’installation des sites Configuration Manager.
Remarque
Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.
Exemples
Exemple 1 : Créer un site secondaire
Cette première commande crée un objet de paramètres SQL Server. Cet objet spécifie que Microsoft SQL Server Express est copié sur un site secondaire Configuration Manager. La commande stocke l’objet dans la variable $CIObj .
La deuxième commande crée un site secondaire nommé Site distant Contoso qui a le code de site CM2 sur le serveur nommé server2.corp.contoso.com. La commande spécifie l’objet de paramètres SQL Server pour le site secondaire stocké dans $CIObj. La commande spécifie le site principal du site secondaire qui a le code de site CM1.
$CIObj = New-CMSqlServerSetting -CopySqlServerExpressOnSecondarySite
New-CMSecondarySite -CertificateExpirationTimeUtc "2/1/2020 12:00 AM" -CreateSelfSignedCertificate -Https -InstallationSourceFile "\\ContosoServer1\SourceFiles" -InstallInternetServer $True -ParentSiteCode "CM1" -ServerName "server2.corp.contoso.com" -SiteCode "CM2" -SiteName "Contoso remote site" -SqlServerSetting $CIObjParamè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 site secondaire peut préparer 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 |
-BoundaryGroup
Spécifiez un tableau d’objets de groupe de limites pour ce système de site. Pour obtenir cet objet, utilisez l’applet de commande Get-CMBoundaryGroup .
| Type: | IResultObject[] |
| Alias: | BoundaryGroups |
| 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 auxquelles le certificat auto-signé expire pour un point de distribution sur le site secondaire.
| 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 du certificat importé PKI pour le point de distribution.
| Type: | SecureString |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| 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. Ce paramètre s’applique lorsque le site secondaire a installé et configuré IIS pour créer un point de distribution.
| 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 |
-ClientConnectionType
Spécifie le type de connexion client.
| 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 |
-ContentMonitoringPriority
Spécifie la priorité de surveillance du contenu.
| 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 |
-CreateSelfSignedCertificate
Indique que le site secondaire crée un certificat auto-signé pour le point de distribution.
| Type: | SwitchParameter |
| 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 les ordinateurs clients communiquent de manière anonyme avec le point de distribution. Ce paramètre s’applique lorsque le site secondaire a installé et configuré IIS pour créer un 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 |
-EnableBranchCache
Indique que les clients qui utilisent Windows BranchCache sont autorisés à télécharger du contenu à partir d’un point de distribution local.
| 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 |
-ForceWhenDuplicateCertificate
Indique si Configuration Manager remplace un certificat en double lorsque vous importez un certificat client PKI pour le site secondaire.
| 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 |
-Http
Indique que les ordinateurs clients communiquent avec le point de distribution à l’aide de HTTP. Ce paramètre s’applique lorsque le site secondaire a installé et configuré IIS pour créer un point de distribution. \
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Https
Indique que les ordinateurs clients communiquent avec le point de distribution à l’aide du protocole HTTPS. Ce paramètre s’applique lorsque le site secondaire a installé et configuré IIS pour créer un point de distribution.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ImportCertificate
Indique que l’applet de commande importe un certificat PKI au lieu d’utiliser un certificat auto-signé pour le point de distribution.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-InstallationFolder
Spécifie le dossier d’installation sur le serveur de site secondaire où l’applet de commande installe les fichiers du site.
| Type: | String |
| Alias: | InstallDir |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-InstallationSourceFile
Spécifie un tableau d’objets de fichier source d’installation pour Configuration Manager. Pour obtenir cet objet, utilisez l’applet de commande New-CMInstallationSourceFile .
| Type: | IResultObject[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-InstallInternetServer
Spécifie s’il faut installer et configurer IIS si Configuration Manager l’exige.
Ce paramètre doit être $True avant que l’applet de commande installe le rôle de système de site pour le point de distribution sur le site secondaire.
| 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 |
-MinFreeSpaceMB
Spécifie la quantité d’espace, en mégaoctets, à réserver sur chaque lecteur utilisé par le point de distribution. Cette valeur détermine l’espace libre restant sur le lecteur après que la distribution a stocke le contenu sur le lecteur.
À compter de la version 2107, l’espace libre minimal par défaut est passé de 200 Mo à 500 Mo.
| 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 |
-PrimaryContentLibraryLocation
Spécifie un emplacement de bibliothèque de contenu principal.
| 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 un emplacement de partage de package principal.
| 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 |
-PrimarySiteCode
Spécifiez le code de site à trois caractères du site parent.
| Type: | String |
| Alias: | ParentSiteCode |
| 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 un emplacement de bibliothèque de contenu secondaire.
| 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 un emplacement de partage de package secondaire.
| 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 |
-SecondarySiteCode
Spécifiez un code de site à trois caractères unique pour le site secondaire.
| 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 |
-ServerName
Spécifiez le nom de domaine complet (FQDN) du serveur à utiliser comme serveur de site secondaire.
| 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 |
-SiteName
Spécifie le nom du site qui permet d’identifier le site secondaire.
| 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 |
-SqlServerSetting
Spécifie un tableau d’objet de paramètres SQL Server dans Configuration Manager. Pour obtenir cet objet, utilisez l’applet de commande New-CMSqlServerSetting .
| Type: | IResultObject[] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ValidateContentSchedule
Spécifie un objet qui représente un type de planification. Il détermine la fréquence à laquelle Configuration Manager valide l’intégrité des packages sur le point de distribution. Pour créer un objet de jeton de planification, 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
None
Sorties
IResultObject
IResultObject
IResultObject
IResultObject[]
Notes
Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_SCI_SysResUse classe WMI du serveur.