New-CMSecondarySite
Erstellen Sie einen sekundären Standort.
Syntax
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>] Beschreibung
Das Cmdlet New-CMSecondarySite erstellt einen sekundären Standort. Weitere Informationen finden Sie unter Vorbereiten der Installation von Configuration Manager-Standorten.
Hinweis
Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.
Beispiele
Beispiel 1: Erstellen eines sekundären Standorts
Dieser erste Befehl erstellt ein SQL Server-Einstellungsobjekt. Dieses Objekt gibt an, dass Microsoft SQL Server Express an einen sekundären Configuration Manager-Standort kopiert wird. Der Befehl speichert das -Objekt in der variablen $CIObj .
Mit dem zweiten Befehl wird ein sekundärer Standort mit dem Namen Contoso remote site erstellt, der über den Standortcode CM2 auf dem Server namens server2.corp.contoso.com verfügt. Der Befehl gibt das SQL Server-Einstellungsobjekt für den sekundären Standort an, der in $CIObj gespeichert ist. Der Befehl gibt den primären Standort für den sekundären Standort an, der über den Standortcode CM1 verfügt.
$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 $CIObjParameter
-AllowFallbackForContent
Gibt an, ob Clients einen Fallbackquellspeicherort für Inhalte verwenden können.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-AllowPreStaging
Gibt an, ob der sekundäre Standort Inhalte vorab bereitstellen kann.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-BoundaryGroup
Geben Sie ein Array von Begrenzungsgruppenobjekten für dieses Standortsystem an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMBoundaryGroup .
| Typ: | IResultObject[] |
| Aliase: | BoundaryGroups |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CertificateExpirationTimeUtc
Gibt das Datum und die Uhrzeit an, zu dem das selbstsignierte Zertifikat für einen Verteilungspunkt am sekundären Standort abläuft.
| Typ: | DateTime |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CertificatePassword
Gibt das Kennwort für das importierte PKI-Zertifikat für den Verteilungspunkt an.
| Typ: | SecureString |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CertificatePath
Gibt den Importpfad für das von der PKI ausgestellte Zertifikat an, das vom Verteilungspunkt verwendet wird. Dieser Parameter gilt, wenn am sekundären Standort IIS zum Erstellen eines Verteilungspunkts installiert und konfiguriert wurde.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ClientConnectionType
Gibt den Clientverbindungstyp an.
| Typ: | ClientConnectionTypes |
| Zulässige Werte: | Intranet, Internet, InternetAndIntranet |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ContentMonitoringPriority
Gibt die Priorität der Inhaltsüberwachung an.
| Typ: | Priority |
| Zulässige Werte: | Lowest, Low, Medium, High, Highest |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CreateSelfSignedCertificate
Gibt an, dass der sekundäre Standort ein selbstsigniertes Zertifikat für den Verteilungspunkt erstellt.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-EnableAnonymous
Gibt an, ob Clientcomputer anonym mit dem Verteilungspunkt kommunizieren. Dieser Parameter gilt, wenn am sekundären Standort IIS zum Erstellen eines Verteilungspunkts installiert und konfiguriert wurde.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-EnableBranchCache
Gibt an, dass Clients, die Windows BranchCache verwenden, Inhalte von einem lokalen Verteilungspunkt herunterladen dürfen.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ForceWhenDuplicateCertificate
Gibt an, ob Configuration Manager beim Importieren eines PKI-Clientzertifikats für den sekundären Standort ein doppeltes Zertifikat überschreibt.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Http
Gibt an, dass Clientcomputer über HTTP mit dem Verteilungspunkt kommunizieren. Dieser Parameter gilt, wenn am sekundären Standort IIS zum Erstellen eines Verteilungspunkts installiert und konfiguriert wurde. \
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Https
Gibt an, dass Clientcomputer über HTTPS mit dem Verteilungspunkt kommunizieren. Dieser Parameter gilt, wenn am sekundären Standort IIS zum Erstellen eines Verteilungspunkts installiert und konfiguriert wurde.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ImportCertificate
Gibt an, dass das Cmdlet ein PKI-Zertifikat importiert, anstatt ein selbstsigniertes Zertifikat für den Verteilungspunkt zu verwenden.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-InstallationFolder
Gibt den Installationsordner auf dem sekundären Standortserver an, in dem das Cmdlet die Standortdateien installiert.
| Typ: | String |
| Aliase: | InstallDir |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-InstallationSourceFile
Gibt ein Array von Installationsquelldateiobjekten für Configuration Manager an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet New-CMInstallationSourceFile .
| Typ: | IResultObject[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-InstallInternetServer
Gibt an, ob IIS installiert und konfiguriert werden soll, wenn dies von Configuration Manager erforderlich ist.
Dieser Parameter muss sein, $True bevor das Cmdlet die Standortsystemrolle für den Verteilungspunkt am sekundären Standort installiert.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-MinFreeSpaceMB
Gibt den Speicherplatz in Megabyte an, der auf jedem Laufwerk reserviert werden soll, das vom Verteilungspunkt verwendet wird. Dieser Wert bestimmt den verbleibenden freien Speicherplatz auf dem Laufwerk, nachdem die Verteilung Inhalte auf dem Laufwerk gespeichert hat.
Ab Version 2107 wurde der standardmäßige Mindestspeicherplatz von 200 MB auf 500 MB geändert.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PrimaryContentLibraryLocation
Gibt einen primären Speicherort der Inhaltsbibliothek an.
| Typ: | DriveType |
| Zulässige Werte: | 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 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PrimaryPackageShareLocation
Gibt einen primären Paketfreigabespeicherort an.
| Typ: | DriveType |
| Zulässige Werte: | 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 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PrimarySiteCode
Geben Sie den dreistelligen Standortcode der übergeordneten Website an.
| Typ: | String |
| Aliase: | ParentSiteCode |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SecondaryContentLibraryLocation
Gibt einen Speicherort der sekundären Inhaltsbibliothek an.
| Typ: | DriveType |
| Zulässige Werte: | 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 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SecondaryPackageShareLocation
Gibt einen sekundären Paketfreigabespeicherort an.
| Typ: | DriveType |
| Zulässige Werte: | 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 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SecondarySiteCode
Geben Sie einen eindeutigen dreistelligen Standortcode für den sekundären Standort an.
| Typ: | String |
| Aliase: | SiteCode |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ServerName
Geben Sie den vollqualifizierten Domänennamen (FQDN) des Servers an, der als sekundärer Standortserver verwendet werden soll.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SiteName
Gibt den Standortnamen an, mit dem der sekundäre Standort identifiziert werden kann.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SqlServerSetting
Gibt ein Array von SQL Server-Einstellungsobjekten in Configuration Manager an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet New-CMSqlServerSetting .
| Typ: | IResultObject[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ValidateContentSchedule
Gibt ein Objekt an, das einen Zeitplantyp darstellt. Es bestimmt, wie häufig Configuration Manager die Integrität von Paketen auf dem Verteilungspunkt überprüft. Verwenden Sie zum Erstellen eines Zeitplantokenobjekts das Cmdlet New-CMSchedule .
| Typ: | IResultObject |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
None
Ausgaben
IResultObject
IResultObject
IResultObject
IResultObject[]
Hinweise
Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_SCI_SysResUse WMI-Serverklasse.