New-CMCloudManagementGateway

モジュール:

ConfigurationManager

クラウド管理ゲートウェイを作成します。

構文

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>]

説明

このコマンドレットを使用して、Azure でクラウド管理ゲートウェイ (CMG) サービスを作成します。 このコマンドレットを使用してクラウド管理ゲートウェイ (CMG) を作成する方法の詳細については、「 2010 リリース ノート: クラウド管理ゲートウェイ」を参照してください。

詳細については、「 CMG の概要」を参照してください。

バージョン 2010 以降では、このコマンドレットから次のパラメーターが削除されました。

• GovernmentSubscription
• ManagementCertificatePassword
• ManagementCertificatePath
• PassThru
• RootCertificatePath
• ServiceCertificatePassword
• ServiceCertificatePath
• ServiceCName

バージョン 2010 のこのコマンドレットに対するその他の変更の詳細については、 2010 リリース ノートを参照してください。

注:

PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。

例

例 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 以降に適用されます。 クラウド サービスにルート証明書を追加します。

型:	Hashtable
Aliases:	CARootCertification, CARootCertifications
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CheckClientCertRevocation

クライアント証明書の失効を確認するには、このパラメーターを true に設定します。 この検証を機能させるには、証明書失効リスト (CRL) を公開する必要があります。 詳細については、「 証明書失効リストを発行する」を参照してください。

型:	Boolean
Aliases:	VerifyClientCertificateRevocation
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Description

Configuration Manager コンソールで識別しやすくするために、CMG の説明 (省略可能)。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EnableCloudDPFunction

バージョン 2010 以降に適用されます。 [CMG がクラウド配布ポイントとして機能し、Azure Storage からコンテンツを提供することを許可する] オプションを有効または無効にします。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EnableStorageQuota

バージョン 2010 以降に適用されます。 [ ストレージ アラートのしきい値を指定する] オプションを有効または無効にします。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EnableTrafficOut

バージョン 2010 以降に適用されます。 [14 日間のしきい値と送信データ転送を監視するためのアラートを有効にする] オプションを有効または無効にします。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EnforceProtocol

バージョン 2010 以降に適用されます。 TLS 1.2 を適用するオプションを有効または無効にします。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EnvironmentSetting

CMG をデプロイする Azure 環境を指定します。グローバル Azure クラウド (AzurePublicCloud) または Azure Government クラウド (AzureUSGovernmentCloud)。

型:	AzureEnvironment
Aliases:	AzureEnvironmentOption
指定可能な値:	AzurePublicCloud, AzureUSGovernmentCloud
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Force

バージョン 2010 以降に適用されます。 確認を求めずにコマンドを実行します。 サービス証明書に複数の DNS 名が含まれている場合は、このパラメーターを使用してコマンドレットからの警告を回避します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-GroupName

バージョン 2010 以降に適用されます。 Azure リソース グループの名前を指定します。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IsUsingExistingGroup

バージョン 2010 以降に適用されます。 Azure リソース グループが既に存在するかどうかを指定します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Region

Azure サービス リージョン (例: WestUS2) を指定します。

型:	AzureRegion
指定可能な値:	EastUS, SouthCentralUS, WestEurope, SoutheastAsia, WestUS2, WestCentralUS
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ServerAppClientId

バージョン 2010 以降に適用されます。 Microsoft Entra サーバー アプリのクライアント ID を指定します。 このパラメーターは、ユーザー以外の操作モードに使用します。 CMG プロパティでは、この値は Microsoft Entra アプリ名です。

型:	String
Aliases:	ServerApplicationClientId
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ServiceCertPassword

バージョン 2010 以降に適用されます。 サービス証明書のパスワードを指定します。

型:	SecureString
Aliases:	ServiceCertificatePassword
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ServiceCertPath

バージョン 2010 以降に適用されます。 サービス証明書へのパスを指定します。 詳細については、「 CMG サーバー認証証明書」を参照してください。

型:	String
Aliases:	ServiceCertificatePath
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ServiceName

バージョン 2010 以降に適用されます。 Azure サービス名を指定します。 このパラメーターを指定しない場合、Configuration Manager はサービス証明書の最初の DNS 名を使用します。 証明書に複数の DNS 名がある場合は、このパラメーターを使用して、使用する DNS 名を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-StorageCriticalPct

バージョン 2010 以降に適用されます。 重大なアラートの生成 (ストレージ アラートしきい値の割合) の整数値を指定します。 たとえば、「 90 」のように入力します。

型:	Int32
Aliases:	StorageCriticalPercent
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-StorageQuotaGB

バージョン 2010 以降に適用されます。 ストレージ アラートしきい値 (GB) の整数値を指定します。 たとえば、「 2 」のように入力します。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-StorageWarningPct

バージョン 2010 以降に適用されます。 [警告の生成] アラートの整数値 (ストレージ アラートのしきい値の割合) を指定します。 たとえば、「 50 」のように入力します。

型:	Int32
Aliases:	StorageWarningPercent
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SubscriptionId

この新しいクラウド サービスをデプロイする Azure サブスクリプションの ID を指定します。 この値の形式は標準の GUID です。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-TenantId

cmg の作成時に tenantId を追加する必要がある必須パラメーター。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-TrafficCriticalPct

送信データ転送を監視するためのアラートを有効にする場合は、 重大アラート を発生させるしきい値の割合を指定します。 この値は既定で 90 されます。

型:	Int32
Aliases:	TrafficCriticalPercent
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-TrafficOutGB

ストレージ アラートを有効にする場合は、このパラメーターを使用してストレージ アラートのしきい値を GB 単位で指定します。 既定値は 2 です。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-TrafficOutStopService

バージョン 2010 以降に適用されます。 [重大なしきい値を超えたときにこのサービスを停止する] オプションを有効または無効にします。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-TrafficWarningPct

送信データ転送を監視するためのアラートを有効にする場合は、 警告 アラートを発生させるしきい値の割合を指定します。 この値は既定で 50 されます。

型:	Int32
Aliases:	TrafficWarningPercent
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VMInstanceCount

Azure の CMG の仮想マシンのインスタンス数を指定します。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

None

出力

IResultObject

関連リンク

• Get-CMCloudManagementGateway
• Remove-CMCloudManagementGateway
• Set-CMCloudManagementGateway
• Start-CMCloudManagementGateway
• Stop-CMCloudManagementGateway
• Import-CMAADServerApplication
• Import-CMAADClientApplication
• New-CMCloudManagementAzureService
• New-CMCloudManagementGateway
• Add-CMCloudManagementGatewayConnectionPoint
• Set-CMCloudManagementAzureService
• CMG の概要