New-CMSecondarySite

SYNOPSIS

Skapa en sekundär plats.

SYNTAX

NewDistributionPointByHTTPAndCreateCertificate (standard)

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

Cmdleten New-CMSecondarySite skapar en sekundär plats. Mer information finns i Förbereda installationen av Konfigurationshanteraren webbplatser.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Skapa en sekundär plats

Det här första kommandot skapar SQL Server ett inställningsobjekt. Det här objektet anger Microsoft SQL Server Express kopieras till en Konfigurationshanteraren sekundär plats. Kommandot lagrar objektet i $CIObj variabeln.

Det andra kommandot skapar en sekundär plats med namnet Contoso fjärrplats som har platskoden CM2 på servern med namnet server2.corp.contoso.com. Kommandot anger det SQL Server inställningsobjektet för den sekundära platsen som lagras i $CIObj. Kommandot anger den primära platsen för den sekundära platsen som har platskoden 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 $CIObj

PARAMETERS

-AllowFallbackForContent

Anger om klienter kan använda en återställningskälla för innehåll.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowPreStaging

Anger om den sekundära platsen kan förinstallera innehåll.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-BoundaryGroup

Ange en matris med gränsgruppsobjekt för det här platssystemet. Hämta det här objektet med hjälp av cmdleten Get-CMBoundaryGroup.

Type: IResultObject[]
Parameter Sets: (All)
Aliases: BoundaryGroups

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

-CertificateExpirationTimeUtc

Anger det datum och den tid då det själv signerade certifikatet upphör att gälla för en distributionsplats på den sekundära platsen.

Type: DateTime
Parameter Sets: NewDistributionPointByHTTPAndCreateCertificate, NewDistributionPointByHTTPSAndCreateCertificate
Aliases:

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

-CertificatePassword

Anger lösenordet för det PKI-importerade certifikatet för distributionsplatsen.

Type: SecureString
Parameter Sets: NewDistributionPointByHTTPSAndImportCertificate, NewDistributionPointByHTTPAndImportCertificate
Aliases:

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

-CertificatePath

Anger importsökvägen för det PKI-utfärdade certifikat som distributionsplatsen använder. Den här parametern gäller när den sekundära platsen har installerat och konfigurerat IIS för att skapa en distributionsplats.

Type: String
Parameter Sets: NewDistributionPointByHTTPSAndImportCertificate, NewDistributionPointByHTTPAndImportCertificate
Aliases:

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

-ClientConnectionType

Anger klientanslutningstypen.

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

Uppmanar dig att bekräfta innan du kör cmdleten.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-ContentMonitoringPriority

Anger prioritet för innehållsövervakning.

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

Anger att den sekundära platsen skapar ett själv signerat certifikat för distributionsplatsen.

Type: SwitchParameter
Parameter Sets: NewDistributionPointByHTTPAndCreateCertificate, NewDistributionPointByHTTPSAndCreateCertificate
Aliases:

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

-DisableWildcardHandling

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-EnableAnonymous

Anger om klientdatorer kommunicerar anonymt med distributionsplatsen. Den här parametern gäller när den sekundära platsen har installerat och konfigurerat IIS för att skapa en distributionsplats.

Type: Boolean
Parameter Sets: NewDistributionPointByHTTPAndCreateCertificate, NewDistributionPointByHTTPAndImportCertificate
Aliases:

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

-EnableBranchCache

Anger att klienter som använder Windows BranchCache tillåts ladda ned innehåll från en lokal distributionsplats.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWhenDuplicateCertificate

Anger om Konfigurationshanteraren skriver över ett duplicerat certifikat när du importerar ett PKI-klientcertifikat för den sekundära platsen.

Type: Boolean
Parameter Sets: NewDistributionPointByHTTPSAndImportCertificate, NewDistributionPointByHTTPAndImportCertificate
Aliases:

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

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Http

Anger att klientdatorerna kommunicerar med distributionsplatsen via HTTP. Den här parametern gäller när den sekundära platsen har installerat och konfigurerat IIS för att skapa en distributionsplats. \

Type: SwitchParameter
Parameter Sets: NewDistributionPointByHTTPAndCreateCertificate, NewDistributionPointByHTTPAndImportCertificate
Aliases:

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

-Https

Anger att klientdatorerna kommunicerar med distributionsplatsen med hjälp av HTTPS. Den här parametern gäller när den sekundära platsen har installerat och konfigurerat IIS för att skapa en distributionsplats.

Type: SwitchParameter
Parameter Sets: NewDistributionPointByHTTPSAndCreateCertificate, NewDistributionPointByHTTPSAndImportCertificate
Aliases:

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

-ImportCertificate

Anger att cmdleten importerar ett PKI-certifikat i stället för att använda ett själv signerat certifikat för distributionsplatsen.

Type: SwitchParameter
Parameter Sets: NewDistributionPointByHTTPSAndImportCertificate, NewDistributionPointByHTTPAndImportCertificate
Aliases:

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

-InstallInternetServer

Anger om du vill installera och konfigurera IIS om Konfigurationshanteraren kräver det. Den här parametern $True måste vara innan cmdleten installerar platssystemrollen för distributionsplatsen på den sekundära platsen.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-InstallationFolder

Anger installationsmappen på den sekundära platsservern där cmdleten installerar platsfilerna.

Type: String
Parameter Sets: (All)
Aliases: InstallDir

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

-InstallationSourceFile

Anger en matris med installationskällfilobjekt för Konfigurationshanteraren. Hämta det här objektet med hjälp av cmdleten New-CMInstallationSourceFile.

Type: IResultObject[]
Parameter Sets: (All)
Aliases:

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

-MinFreeSpaceMB

Anger hur mycket utrymme i megabyte som ska reserveras på varje enhet som distributionsplatsen använder. Det här värdet avgör återstående ledigt utrymme på enheten efter att distributionen lagrar innehåll på enheten.

Från och med version 2107 har det minsta lediga standardutrymmet ändrats från 200 MB till 500 MB.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-PrimaryContentLibraryLocation

Anger en primär plats för innehållsbiblioteket.

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

Anger en primär paketresursplats.

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

Ange platskoden med tre tecken för den överordnade platsen.

Type: String
Parameter Sets: (All)
Aliases: ParentSiteCode

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

-SecondaryContentLibraryLocation

Anger en plats för sekundärt innehållsbibliotek.

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

Anger en sekundär paketresursplats.

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

Ange en unik platskod med tre tecken för den sekundära platsen.

Type: String
Parameter Sets: (All)
Aliases: SiteCode

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

-ServerName

Ange det fullständigt kvalificerade domännamnet (FQDN) för servern som ska användas som sekundär platsserver.

Type: String
Parameter Sets: (All)
Aliases:

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

-SiteName

Anger det platsnamn som hjälper dig att identifiera den sekundära platsen.

Type: String
Parameter Sets: (All)
Aliases:

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

-SqlServerSetting

Anger en matris med SQL Server inställningsobjekt i Konfigurationshanteraren. Hämta det här objektet med hjälp av cmdleten New-CMSqlServerSetting.

Type: IResultObject[]
Parameter Sets: (All)
Aliases:

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

-ValidateContentSchedule

Anger ett objekt som representerar en schematyp. Den avgör hur Konfigurationshanteraren verifierar paketens integritet på distributionsplatsen. Om du vill skapa ett schematokenobjekt använder du cmdleten New-CMSchedule.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Ingen

OUTPUTS

IResultObject#SMS_Site

IResultObject#SMS_SCI_SiteDefinition

IResultObject#SMS_SCI_SysResUse

IResultObject[]#SMS_SCI_Address

ANTECKNINGAR

Mer information om det här returobjektet och dess egenskaper finns i SMS_SCI_SysResUse serverns WMI-klass.

New-CMInstallationSourceFile

New-CMSqlServerSetting

Remove-CMSecondarySite