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 リリースノートを参照してください。

注:

Configuration Manager サイトドライブからConfiguration Managerコマンドレットを実行します (例: 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

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

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

-Description

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

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 Storage からコンテンツを提供することを許可する] オプションを有効または無効にします。

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 名が含まれている場合は、このパラメーターを使用してコマンドレットからの警告を回避します。

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 サーバーアプリのクライアント ID を指定します。このパラメーターは、ユーザー以外の操作モードに使用します。 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 サブスクリプションの ID を指定します。この値の形式は標準の 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

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

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

入力

None

出力

IResultObject