Set-CMCloudManagementGateway

クラウド管理ゲートウェイ (CMG) を構成します。

構文

Set-CMCloudManagementGateway
   [-CARootCert <Hashtable>]
   [-CheckClientCertRevocation <Boolean>]
   [-Description <String>]
   [-EnableCloudDPFunction <Boolean>]
   [-EnableStorageQuota <Boolean>]
   [-EnableTrafficOut <Boolean>]
   [-EnforceProtocol <Boolean>]
   [-Force]
   -InputObject <IResultObject>
   [-PassThru]
   [-RemoveCertThumbprints <String[]>]
   [-ServiceCertPassword <SecureString>]
   [-ServiceCertPath <String>]
   [-StorageCriticalPct <Int32>]
   [-StorageQuotaGB <Int32>]
   [-StorageWarningPct <Int32>]
   [-TrafficCriticalPct <Int32>]
   [-TrafficOutGB <Int32>]
   [-TrafficOutStopService <Boolean>]
   [-TrafficWarningPct <Int32>]
   [-VMInstanceCount <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMCloudManagementGateway
   [-CARootCert <Hashtable>]
   [-CheckClientCertRevocation <Boolean>]
   [-Description <String>]
   [-EnableCloudDPFunction <Boolean>]
   [-EnableStorageQuota <Boolean>]
   [-EnableTrafficOut <Boolean>]
   [-EnforceProtocol <Boolean>]
   [-Force]
   -Id <String>
   [-PassThru]
   [-RemoveCertThumbprints <String[]>]
   [-ServiceCertPassword <SecureString>]
   [-ServiceCertPath <String>]
   [-StorageCriticalPct <Int32>]
   [-StorageQuotaGB <Int32>]
   [-StorageWarningPct <Int32>]
   [-TrafficCriticalPct <Int32>]
   [-TrafficOutGB <Int32>]
   [-TrafficOutStopService <Boolean>]
   [-TrafficWarningPct <Int32>]
   [-VMInstanceCount <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMCloudManagementGateway
   [-CARootCert <Hashtable>]
   [-CheckClientCertRevocation <Boolean>]
   [-Description <String>]
   [-EnableCloudDPFunction <Boolean>]
   [-EnableStorageQuota <Boolean>]
   [-EnableTrafficOut <Boolean>]
   [-EnforceProtocol <Boolean>]
   [-Force]
   -Name <String>
   [-PassThru]
   [-RemoveCertThumbprints <String[]>]
   [-ServiceCertPassword <SecureString>]
   [-ServiceCertPath <String>]
   [-StorageCriticalPct <Int32>]
   [-StorageQuotaGB <Int32>]
   [-StorageWarningPct <Int32>]
   [-TrafficCriticalPct <Int32>]
   [-TrafficOutGB <Int32>]
   [-TrafficOutStopService <Boolean>]
   [-TrafficWarningPct <Int32>]
   [-VMInstanceCount <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

クラウド管理ゲートウェイ (CMG) を構成するには、このコマンドレットを使用します。

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

注:

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

例 1: CMG アラートの構成を変更する

Set-CMCloudManagementGateway -Name "GraniteFalls" -EnableTrafficOut $true -TrafficOutGB 10000 -TrafficWarningPct 50 -TrafficCriticalPct 90 -EnableStorageQuota $true -StorageQuotaGB 2000 -StorageWarningPct 50 -StorageCriticalPct 90

例 2: CMG サービスの仮想マシンの数を変更する

この例では、 GraniteFalls という名前の CMG をターゲットにし、VM の数を 4に変更します。

Set-CMCloudManagementGateway -Name "GraniteFalls" -VMInstancesCount 4

例 3: CMG が Azure ストレージからコンテンツを提供できるようにする

Set-CMCloudManagementGateway -Name "GraniteFalls" -EnableCloudDPFunction $true

例 4: 2 つの新しい証明機関を追加する

$path1 = "folder\root.cer"
$type1 = [Microsoft.ConfigurationManagement.AdminConsole.AzureServices.CertificateStore]::RootCA

$path2 = "folder\intermediate.cer"
$type2 = [Microsoft.ConfigurationManagement.AdminConsole.AzureServices.CertificateStore]::IntermediateCA

$cert = @{$path1 = $type1; $path2 = $type2}

Set-CMCloudManagementGateway -Name "GraniteFalls" -CARootCert $cert

例 5: CMG サーバー認証証明書を更新する

この例では、 GraniteFalls という名前の CMG をターゲットにし、CMG サーバー認証証明書を更新します。

Set-CMCloudManagementGateway -Name "GraniteFalls" -ServiceCertPath "c:\TestPath\NewServiceCert.pfx" -ServiceCertPassword (ConvertTo-SecureString -String "tX*xJ11Nuo^B" -AsPlainText -Force)

例 6: CMG からルート証明書を削除する

Set-CMCloudManagementGateway -Name "GraniteFalls" -RemoveCertThumbprints "A7CBA0014DEF847593569D05003D5B96A1D6A627"

パラメーター

-CARootCert

クラウド サービスにルート証明書を追加します。

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

-CheckClientCertRevocation

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

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

-Confirm

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

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

-Description

この CMG サービスをより適切に識別するために、この 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

-Force

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

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

-ForceWildcardHandling

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

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

-Id

Azure サービスのサイトの ID を指定します。 Id は、サービスのサイト データベースに格納されている整数値です。 たとえば、次の SQL クエリを実行し、 ID 列を確認します: select * from Azure_CloudService

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

-InputObject

構成する CMG オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMCloudManagementGateway コマンドレットを使用します。

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

-Name

構成する CMG の名前を指定します。

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

-PassThru

作業中のアイテムを表す オブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。

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

-RemoveCertThumbprints

バージョン 2010 以降に適用されます。 1 つ以上の証明書拇印を指定して、CMG からルート証明機関または中間証明機関として削除します。

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

-ServiceCertPassword

バージョン 2006 以降に適用されます。 -ServiceCertPath で証明書のパスワードを指定します。

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

-ServiceCertPath

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

型:String
Aliases:ServiceCertificatePath
配置: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

-TrafficCriticalPct

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

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

-TrafficOutGB

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

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

-TrafficOutStopService

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

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

-TrafficWarningPct

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

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

-VMInstanceCount

バージョン 2010 以降に適用されます。 仮想マシンのインスタンス数を指定します。

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

-WhatIf

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object