New-CMCloudManagementGateway

參考

模組:: ConfigurationManager

建立雲端管理閘道。

Syntax

New-CMCloudManagementGateway
   [-CARootCert <Hashtable>]
   [-CheckClientCertRevocation <Boolean>]
   [-Description <String>]
   [-EnableCloudDPFunction <Boolean>]
   [-EnableStorageQuota <Boolean>]
   [-EnableTrafficOut <Boolean>]
   [-EnforceProtocol <Boolean>]
   [-EnvironmentSetting <AzureEnvironment>]
   [-Force]
   [-GroupName <String>]
   [-IsUsingExistingGroup <Boolean>]
   [-Region <AzureRegion>]
   -ServiceCertPassword <SecureString>
   -ServiceCertPath <String>
   [-ServiceName <String>]
   [-StorageCriticalPct <Int32>]
   [-StorageQuotaGB <Int32>]
   [-StorageWarningPct <Int32>]
   [-SubscriptionId <String>]
   [-TrafficCriticalPct <Int32>]
   [-TrafficOutGB <Int32>]
   [-TrafficOutStopService <Boolean>]
   [-TrafficWarningPct <Int32>]
   [-VMInstanceCount <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMCloudManagementGateway
   [-CARootCert <Hashtable>]
   [-CheckClientCertRevocation <Boolean>]
   [-Description <String>]
   [-EnableCloudDPFunction <Boolean>]
   [-EnableStorageQuota <Boolean>]
   [-EnableTrafficOut <Boolean>]
   [-EnforceProtocol <Boolean>]
   [-EnvironmentSetting <AzureEnvironment>]
   [-Force]
   -GroupName <String>
   [-Region <AzureRegion>]
   -ServerAppClientId <String>
   -ServiceCertPassword <SecureString>
   -ServiceCertPath <String>
   [-ServiceName <String>]
   [-StorageCriticalPct <Int32>]
   [-StorageQuotaGB <Int32>]
   [-StorageWarningPct <Int32>]
   -SubscriptionId <String>
   [-TrafficCriticalPct <Int32>]
   [-TrafficOutGB <Int32>]
   [-TrafficOutStopService <Boolean>]
   [-TrafficWarningPct <Int32>]
   [-VMInstanceCount <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

使用此 Cmdlet 在 Azure 中 (CMG) 服務建立雲端管理閘道。如需如何使用此 Cmdlet 建立雲端管理閘道 (CMG) 的詳細資訊，請參閱 2010 版本資訊：雲端管理閘道。

如需詳細資訊，請參閱 CMG 概觀。

從 2010 版開始，已從此 Cmdlet 中移除下列參數：

GovernmentSubscription
ManagementCertificatePassword
ManagementCertificatePath
PassThru
RootCertificatePath
ServiceCertificatePassword
ServiceCertificatePath
ServiceCName

如需 2010 版中此 Cmdlet 的其他變更詳細資訊，請參閱 2010 版本資訊。

注意事項

從Configuration Manager月臺磁片磁碟機執行 Configuration Manager Cmdlet，例如 PS XYZ:\> 。如需詳細資訊，請參閱開始使用。

範例

範例 1

$Path = "c:\TestPath\RootCA.cer"
$Type = [Microsoft.ConfigurationManagement.AdminConsole.AzureServices.CertificateStore]::RootCA
$Cert =@{$Path = $Type}

$Password = '0HNy*c@63kAe' | ConvertTo-SecureString -AsPlainText -Force

New-CMCloudManagementGateway -ServiceCertPath "c:\TestPath\ServiceCert.pfx" -EnvironmentSetting AzurePublicCloud -SubscriptionId "e517b8cb-a969-4d1e-b2ea-ae1e6c052020" -ServiceCertPassword $Password -ServiceName "GraniteFalls.CloudApp.Net" -Description "EastUS CMG for Contoso" -Region EastUS -VMInstanceCount 2 -CARootCert $Cert -CheckClientCertRevocation $False -EnforceProtocol $True -IsUsingExistingGroup $true -GroupName "Resource group 1"

範例 2

New-CMCloudManagementGateway -ServiceCertPath "c:\TestPath\ServiceCert.pfx" -EnvironmentSetting AzurePublicCloud -SubscriptionId "e517b8cb-a969-4d1e-b2ea-ae1e6c052020" -ServiceCertPassword $Password -ServiceName "GraniteFalls.CloudApp.Net" -Description "EastUS CMG for Contoso" -Region EastUS -VMInstanceCount 2 -CARootCert $Cert -CheckClientCertRevocation $False -EnforceProtocol $True -GroupName "Resource group 1" -EnableCloudDPFunction $true -EnableTrafficOut $true -TrafficOutStopService $true -TrafficOutGB 10000 -TrafficWarningPct 50 -TrafficCriticalPct 90 -EnableStorageQuota $true -StorageQuotaGB 2000 -StorageWarningPct 50 -StorageCriticalPct 90 -Force

參數

-CARootCert

適用于 2010 版和更新版本。將根憑證新增至雲端服務。

Type:	Hashtable
Aliases:	CARootCertification, CARootCertifications
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CheckClientCertRevocation

將此參數設定為， true 以驗證用戶端憑證撤銷。 (CRL) 的憑證撤銷清單必須公開發布，此驗證才能運作。如需詳細資訊，請參閱發佈憑證撤銷清單。

Type:	Boolean
Aliases:	VerifyClientCertificateRevocation
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

執行 Cmdlet 之前提示您確認。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

CMG 的選擇性描述，以便在Configuration Manager主控台中更妥善地識別它。

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

-DisableWildcardHandling

此參數會將萬用字元視為常值字元值。您無法將其與 ForceWildcardHandling結合。

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

-EnableCloudDPFunction

適用于 2010 版和更新版本。啟用或停用 [ 允許 CMG 作為雲端發佈點並從 Azure 儲存體提供內容] 選項。

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

-EnableStorageQuota

適用于 2010 版和更新版本。啟用或停用 [ 指定儲存體警示閾值] 選項。

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

-EnableTrafficOut

適用于 2010 版和更新版本。啟用或停用 [ 開啟 14 天閾值和警示] 選項，以監視輸出資料傳輸。

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

-EnforceProtocol

適用于 2010 版和更新版本。啟用或停用 [強制執行 TLS 1.2]選項。

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

-EnvironmentSetting

指定要部署 CMG 的 Azure 環境：在全域 Azure 雲端 () AzurePublicCloud 或Azure Government雲端 (AzureUSGovernmentCloud) 中。

Type:	AzureEnvironment
Aliases:	AzureEnvironmentOption
Accepted values:	AzurePublicCloud, AzureUSGovernmentCloud
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

適用于 2010 版和更新版本。執行命令而不要求確認。如果服務憑證包含多個 DNS 名稱，請使用此參數來避免來自 Cmdlet 的警告。

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

-ForceWildcardHandling

此參數會處理萬用字元，並可能導致非預期的行為 (不建議) 。您無法將其與 DisableWildcardHandling結合。

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

-GroupName

適用于 2010 版和更新版本。指定 Azure 資源群組的名稱。

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

-IsUsingExistingGroup

適用于 2010 版和更新版本。指定 Azure 資源群組是否已存在。

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

-Region

指定 Azure 服務區域，例如： WestUS2 。

Type:	AzureRegion
Accepted values:	EastUS, SouthCentralUS, WestEurope, SoutheastAsia, WestUS2, WestCentralUS
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerAppClientId

適用于 2010 版和更新版本。指定Microsoft Entra伺服器應用程式的用戶端識別碼。針對非使用者互動模式使用此參數。在 CMG 屬性中，此值是Microsoft Entra應用程式名稱。

Type:	String
Aliases:	ServerApplicationClientId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ServiceCertPassword

適用于 2010 版和更新版本。指定服務憑證的密碼。

Type:	SecureString
Aliases:	ServiceCertificatePassword
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ServiceCertPath

適用于 2010 版和更新版本。指定服務憑證的路徑。如需詳細資訊，請參閱 CMG 伺服器驗證憑證。

Type:	String
Aliases:	ServiceCertificatePath
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ServiceName

適用于 2010 版和更新版本。指定 Azure 服務名稱。如果您未指定此參數，Configuration Manager使用服務憑證的第一個 DNS 名稱。如果憑證有多個 DNS 名稱，請使用此參數來指定要使用的 DNS 名稱。

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

-StorageCriticalPct

適用于 2010 版和更新版本。指定儲存體警示閾值的 [ 產生重大警示 (% 的整數值) 。例如，90。

Type:	Int32
Aliases:	StorageCriticalPercent
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StorageQuotaGB

適用于 2010 版和更新版本。指定 儲存體警示閾值 的整數值 (GB) 。例如，2。

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

-StorageWarningPct

適用于 2010 版和更新版本。針對儲存體 警示閾值的 [產生警告警示 (% 指定整數值) 。例如，50。

Type:	Int32
Aliases:	StorageWarningPercent
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

指定您要在其中部署此新雲端服務的 Azure 訂用帳戶識別碼。這個值的格式是標準 GUID。

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

-TenantId

建立 cmg 時，必須新增 tenantId 的必要參數。

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

-TrafficCriticalPct

如果您啟用警示來監視輸出資料傳輸，請指定引發重大警示的閾值百分比。此值默 90 認為。

Type:	Int32
Aliases:	TrafficCriticalPercent
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TrafficOutGB

如果您啟用儲存體警示，請使用此參數以 GB指定儲存體警示閾值。預設值為 2。

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

-TrafficOutStopService

適用于 2010 版和更新版本。啟用或停用 在超過臨界值時停止此服務的選項。

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

-TrafficWarningPct

如果您啟用警示來監視輸出資料傳輸，請指定引發警告警示的閾值百分比。此值默 50 認為。

Type:	Int32
Aliases:	TrafficWarningPercent
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VMInstanceCount

在 Azure 中指定 CMG 的虛擬機器實例計數。

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

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

輸入

None

輸出

IResultObject