New-CMSecondarySite
SYNOPSIS
Maak een secundaire site.
SYNTAX
NewDistributionPointByHTTPAndCreateCertificate (standaard)
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>]
NewDistributionPointByHTTPSAndCreateCertificate
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>]
NewDistributionPointByHTTPSAndImportCertificate
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>]
NewDistributionPointByHTTPAndImportCertificate
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
Met de cmdlet New-CMSecondarySite wordt een secundaire site gemaakt. Zie Voorbereiden voor het installeren van Configuration Manager sites voor meer informatie.
Notitie
Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.
EXAMPLES
Voorbeeld 1: Een secundaire site maken
Met deze eerste opdracht maakt u een SQL Server instellingenobject. Dit object geeft aan dat Microsoft SQL Server Express wordt gekopieerd naar een Configuration Manager secundaire site. De opdracht slaat het object op in de $CIObj variabele.
Met de tweede opdracht maakt u een secundaire site met de naam Contoso remote site met de sitecode CM2 op de server met de naam server2.corp.contoso.com. Met de opdracht geeft u het SQL Server instellingenobject op voor de secundaire site die is opgeslagen in $CIObj. Met de opdracht geeft u de primaire site op voor de secundaire site die de sitecode CM1 heeft.
$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 $CIObj
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 de secundaire site inhoud kan vooraf plaatsen.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-BoundaryGroup
Geef een matrix van grensgroepsobjecten op voor dit sitesysteem. Gebruik de cmdlet Get-CMBoundaryGroup om dit object op te halen.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: BoundaryGroups
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CertificateExpirationTimeUtc
Hiermee geeft u de datum en tijd op waarop het zelf-ondertekende certificaat verloopt voor een distributiepunt op de secundaire site.
Type: DateTime
Parameter Sets: NewDistributionPointByHTTPAndCreateCertificate, NewDistributionPointByHTTPSAndCreateCertificate
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CertificatePassword
Hiermee geeft u het wachtwoord op voor het geïmporteerde PKI-certificaat voor het distributiepunt.
Type: SecureString
Parameter Sets: NewDistributionPointByHTTPSAndImportCertificate, NewDistributionPointByHTTPAndImportCertificate
Aliases:
Required: True
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. Deze parameter is van toepassing wanneer de secundaire site IIS heeft geïnstalleerd en geconfigureerd om een distributiepunt te maken.
Type: String
Parameter Sets: NewDistributionPointByHTTPSAndImportCertificate, NewDistributionPointByHTTPAndImportCertificate
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ClientConnectionType
Hiermee geeft u het verbindingstype van de client op.
Type: ClientConnectionTypes
Parameter Sets: NewDistributionPointByHTTPSAndCreateCertificate, NewDistributionPointByHTTPSAndImportCertificate
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
-ContentMonitoringPriority
Hiermee geeft u de prioriteit voor inhoudscontrole op.
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
-CreateSelfSignedCertificate
Geeft aan dat de secundaire site een zelf-ondertekend certificaat voor het distributiepunt maakt.
Type: SwitchParameter
Parameter Sets: NewDistributionPointByHTTPAndCreateCertificate, NewDistributionPointByHTTPSAndCreateCertificate
Aliases:
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 clientcomputers anoniem communiceren met het distributiepunt. Deze parameter is van toepassing wanneer de secundaire site IIS heeft geïnstalleerd en geconfigureerd om een distributiepunt te maken.
Type: Boolean
Parameter Sets: NewDistributionPointByHTTPAndCreateCertificate, NewDistributionPointByHTTPAndImportCertificate
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableBranchCache
Geeft aan dat clients die gebruikmaken Windows BranchCache inhoud van een on-premises distributiepunt mogen downloaden.
Type: SwitchParameter
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 de secundaire site importeert.
Type: Boolean
Parameter Sets: NewDistributionPointByHTTPSAndImportCertificate, NewDistributionPointByHTTPAndImportCertificate
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
-Http
Geeft aan dat clientcomputers communiceren met het distributiepunt via HTTP. Deze parameter is van toepassing wanneer de secundaire site IIS heeft geïnstalleerd en geconfigureerd om een distributiepunt te maken. \
Type: SwitchParameter
Parameter Sets: NewDistributionPointByHTTPAndCreateCertificate, NewDistributionPointByHTTPAndImportCertificate
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Https
Geeft aan dat clientcomputers communiceren met het distributiepunt via HTTPS. Deze parameter is van toepassing wanneer de secundaire site IIS heeft geïnstalleerd en geconfigureerd om een distributiepunt te maken.
Type: SwitchParameter
Parameter Sets: NewDistributionPointByHTTPSAndCreateCertificate, NewDistributionPointByHTTPSAndImportCertificate
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ImportCertificate
Geeft aan dat de cmdlet een PKI-certificaat importeert in plaats van een zelf-ondertekend certificaat voor het distributiepunt te gebruiken.
Type: SwitchParameter
Parameter Sets: NewDistributionPointByHTTPSAndImportCertificate, NewDistributionPointByHTTPAndImportCertificate
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InstallInternetServer
Hiermee geeft u op of IIS moet worden geïnstalleerd en geconfigureerd als Configuration Manager dit vereist.
Deze parameter moet zijn voordat de cmdlet de sitesysteemrol voor het distributiepunt op de $True secundaire site installeert.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InstallationFolder
Hiermee geeft u de installatiemap op de secundaire siteserver waar de cmdlet de sitebestanden installeert.
Type: String
Parameter Sets: (All)
Aliases: InstallDir
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InstallationSourceFile
Hiermee geeft u een matrix van bronbestandsobjecten voor de Configuration Manager. Gebruik de cmdlet New-CMInstallationSourceFile om dit object op te halen.
Type: IResultObject[]
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MinFreeSpaceMB
Hiermee geeft u de hoeveelheid ruimte in megabytes te reserveren op elk station dat het distributiepunt gebruikt. Deze waarde bepaalt de resterende vrije ruimte op het station nadat de distributie inhoud op het station op slaat.
Vanaf versie 2107 is de standaard minimale vrije ruimte gewijzigd van 200 MB in 500 MB.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PrimaryContentLibraryLocation
Hiermee geeft u een primaire locatie van de inhoudsbibliotheek.
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 een primaire pakket share.
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
-PrimarySiteCode
Geef de sitecode van drie tekens op van de bovenliggende site.
Type: String
Parameter Sets: (All)
Aliases: ParentSiteCode
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SecondaryContentLibraryLocation
Hiermee geeft u een secundaire locatie van de inhoudsbibliotheek.
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 een secundaire pakket delen.
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
-SecondarySiteCode
Geef een unieke sitecode van drie tekens op voor de secundaire site.
Type: String
Parameter Sets: (All)
Aliases: SiteCode
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ServerName
Geef de FQDN (Fully Qualified Domain Name) van de server op die moet worden gebruikt als de secundaire siteserver.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SiteName
Hiermee geeft u de sitenaam op waarmee u de secundaire site kunt identificeren.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SqlServerSetting
Hiermee geeft u een matrix van SQL Server instellingenobject in Configuration Manager. Gebruik de cmdlet New-CMSqlServerSetting om dit object op te halen.
Type: IResultObject[]
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ValidateContentSchedule
Hiermee geeft u een object dat een schematype vertegenwoordigt. Er wordt bepaald hoe vaak Configuration Manager de integriteit van pakketten op het distributiepunt valideert. Als u een tokenobject 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
Geen
OUTPUTS
IResultObject#SMS_Site
IResultObject#SMS_SCI_SiteDefinition
IResultObject#SMS_SCI_SysResUse
IResultObject[]#SMS_SCI_Address
OPMERKINGEN
Zie WMI-klasse SMS_SCI_SysResUse server voor meer informatie over dit retourobject en de eigenschappen ervan.