New-CMSecondarySite

SYNOPSIS

Utwórz lokację dodatkową.

SYNTAX

NewDistributionPointByHTTPAndCreateCertificate (ustawienie domyślne)

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

Polecenie cmdlet New-CMSecondarySite tworzy lokację dodatkową. Aby uzyskać więcej informacji, zobacz Przygotowanie do instalowania Menedżer konfiguracji lokacjach.

Uwaga

Uruchom Menedżer konfiguracji cmdlet z dysku Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.

EXAMPLES

Przykład 1: tworzenie lokacji dodatkowej

To pierwsze polecenie tworzy obiekt SQL Server ustawienia. Ten obiekt określa, Microsoft SQL Server Express jest kopiowany do lokacji Menedżer konfiguracji lokacji dodatkowej. Polecenie przechowuje obiekt w zmiennej $CIObj zmiennej .

Drugie polecenie tworzy lokację dodatkową o nazwie Lokacja zdalna Contoso, która ma kod lokacji CM2 na serwerze o nazwie server2.corp.contoso.com. Polecenie określa obiekt ustawień SQL Server lokacji dodatkowej przechowywanej w $CIObj. Polecenie określa lokację główną lokacji dodatkowej, która ma kod lokacji 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

Wskazuje, czy klienci mogą używać rezerwowej lokalizacji źródłowej dla zawartości.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowPreStaging

Wskazuje, czy lokacja dodatkowa może wstępnie spretowad zawartość.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-BoundaryGroup

Określ tablicę obiektów grupy granic dla tego systemu lokacji. Aby uzyskać ten obiekt, użyj polecenia cmdlet 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

Określa datę i godzina wygaśnięcia certyfikatu z podpisem własnym dla punktu dystrybucji w lokacji dodatkowej.

Type: DateTime
Parameter Sets: NewDistributionPointByHTTPAndCreateCertificate, NewDistributionPointByHTTPSAndCreateCertificate
Aliases:

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

-CertificatePassword

Określa hasło dla zaimportowanych certyfikatów PKI dla punktu dystrybucji.

Type: SecureString
Parameter Sets: NewDistributionPointByHTTPSAndImportCertificate, NewDistributionPointByHTTPAndImportCertificate
Aliases:

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

-CertificatePath

Określa ścieżkę importu certyfikatu wystawionego przez PKI używanego przez punkt dystrybucji. Ten parametr ma zastosowanie, gdy lokacja dodatkowa zainstalowała i skonfigurowała usługi IIS w celu utworzenia punktu dystrybucji.

Type: String
Parameter Sets: NewDistributionPointByHTTPSAndImportCertificate, NewDistributionPointByHTTPAndImportCertificate
Aliases:

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

-ClientConnectionType

Określa typ połączenia klienta.

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

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

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

-ContentMonitoringPriority

Określa priorytet monitorowania zawartości.

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

Wskazuje, że lokacja dodatkowa tworzy certyfikat z podpisem własnym dla punktu dystrybucji.

Type: SwitchParameter
Parameter Sets: NewDistributionPointByHTTPAndCreateCertificate, NewDistributionPointByHTTPSAndCreateCertificate
Aliases:

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

-DisableWildcardHandling

Ten parametr traktuje symbole wieloznaczne jako wartości literału znaków. Nie można połączyć go z forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-EnableAnonymous

Wskazuje, czy komputery klienckie komunikują się anonimowo z punktem dystrybucji. Ten parametr ma zastosowanie, gdy lokacja dodatkowa zainstalowała i skonfigurowała usługi IIS w celu utworzenia punktu dystrybucji.

Type: Boolean
Parameter Sets: NewDistributionPointByHTTPAndCreateCertificate, NewDistributionPointByHTTPAndImportCertificate
Aliases:

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

-EnableBranchCache

Wskazuje, że klienci, którzy używają usługi Windows BranchCache, mogą pobierać zawartość z lokalnego punktu dystrybucji.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWhenDuplicateCertificate

Wskazuje, Menedżer konfiguracji zastępuje zduplikowany certyfikat podczas importowania certyfikatu klienta PKI dla lokacji dodatkowej.

Type: Boolean
Parameter Sets: NewDistributionPointByHTTPSAndImportCertificate, NewDistributionPointByHTTPAndImportCertificate
Aliases:

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

-ForceWildcardHandling

Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Http

Wskazuje, że komputery klienckie komunikują się z punktem dystrybucji przy użyciu protokołu HTTP. Ten parametr ma zastosowanie, gdy lokacja dodatkowa zainstalowała i skonfigurowała usługi IIS w celu utworzenia punktu dystrybucji. \

Type: SwitchParameter
Parameter Sets: NewDistributionPointByHTTPAndCreateCertificate, NewDistributionPointByHTTPAndImportCertificate
Aliases:

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

-Https

Wskazuje, że komputery klienckie komunikują się z punktem dystrybucji przy użyciu protokołu HTTPS. Ten parametr ma zastosowanie, gdy lokacja dodatkowa zainstalowała i skonfigurowała usługi IIS w celu utworzenia punktu dystrybucji.

Type: SwitchParameter
Parameter Sets: NewDistributionPointByHTTPSAndCreateCertificate, NewDistributionPointByHTTPSAndImportCertificate
Aliases:

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

-ImportCertificate

Wskazuje, że polecenie cmdlet importuje certyfikat PKI zamiast używać certyfikatu z podpisem własnym dla punktu dystrybucji.

Type: SwitchParameter
Parameter Sets: NewDistributionPointByHTTPSAndImportCertificate, NewDistributionPointByHTTPAndImportCertificate
Aliases:

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

-InstallInternetServer

Określa, czy zainstalować i skonfigurować usługi IIS, jeśli Menedżer konfiguracji tego wymaga. Ten parametr musi być przed zainstalowaniem przez polecenie cmdlet roli systemu lokacji dla $True punktu dystrybucji w lokacji dodatkowej.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-InstallationFolder

Określa folder instalacji na serwerze lokacji dodatkowej, na którym polecenie cmdlet instaluje pliki lokacji.

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

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

-InstallationSourceFile

Określa tablicę obiektów pliku źródłowego instalacji dla Menedżer konfiguracji. Aby uzyskać ten obiekt, użyj polecenia cmdlet New-CMInstallationSourceFile.

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

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

-MinFreeSpaceMB

Określa ilość miejsca (w megabajtach) do zarezerwowania na każdym dysku używanym przez punkt dystrybucji. Ta wartość określa pozostałe wolne miejsce na dysku, gdy dystrybucja przechowuje zawartość na dysku.

Począwszy od wersji 2107, domyślna minimalna ilość wolnego miejsca zmieniła się z 200 MB do 500 MB.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-PrimaryContentLibraryLocation

Określa lokalizację podstawowej biblioteki zawartości.

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

Określa lokalizację udziału pakietu podstawowego.

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

Określ trzy znakowy kod lokacji nadrzędnej.

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

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

-SecondaryContentLibraryLocation

Określa dodatkową lokalizację biblioteki zawartości.

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

Określa lokalizację udziału pakietu pomocniczego.

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

Określ unikatowy trzy znakowy kod lokacji dodatkowej.

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

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

-ServerName

Określ w pełni kwalifikowaną nazwę domeny (FQDN) serwera do użycia jako serwer lokacji dodatkowej.

Type: String
Parameter Sets: (All)
Aliases:

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

-SiteName

Określa nazwę lokacji, która pomaga zidentyfikować lokację dodatkową.

Type: String
Parameter Sets: (All)
Aliases:

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

-SqlServerSetting

Określa tablicę obiektów ustawień SQL Server w Menedżer konfiguracji. Aby uzyskać ten obiekt, użyj polecenia cmdlet New-CMSqlServerSetting.

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

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

-ValidateContentSchedule

Określa obiekt, który reprezentuje typ harmonogramu. Określa, jak często program Menedżer konfiguracji sprawdza integralność pakietów w punkcie dystrybucji. Aby utworzyć obiekt tokenu harmonogramu, użyj polecenia 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

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.

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

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

INPUTS

Brak

OUTPUTS

IResultObject#SMS_Site

IResultObject#SMS_SCI_SiteDefinition

IResultObject#SMS_SCI_SysResUse

IResultObject[]#SMS_SCI_Address

UWAGI

Aby uzyskać więcej informacji na temat tego obiektu zwracanego i jego właściwości, zobacz SMS_SCI_SysResUse klasy WMI serwera.

New-CMInstallationSourceFile

New-CMSqlServerSetting

Remove-CMSecondarySite