New-CMSqlServerSetting

Configuration Manager で SQL Server 設定オブジェクトを作成します。

構文

New-CMSqlServerSetting
   [-InstanceName <String>]
   -SiteDatabaseName <String>
   [-SqlServerServiceBrokerPort <Int32>]
   [-UseExistingSqlServerInstance]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSqlServerSetting
   [-CopySqlServerExpressOnSecondarySite]
   [-SqlServerServiceBrokerPort <Int32>]
   [-SqlServerServicePort <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-CMSqlServerSetting コマンドレットは、Configuration Manager で Microsoft SQL Server 設定オブジェクトを作成します。 オブジェクトは、サイト データベースの名前と、SQL Server サービスと SQL Server Service Broker のポート番号の設定を指定します。

注:

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

例 1: SQL Server 設定オブジェクトを作成する

PS XYZ:\> New-CMSqlServerSetting -CopySqlServerExpressOnSecondarySite -SqlServerServiceBrokerPort 4037

このコマンドは、Configuration Manager が Microsoft SQL Server Express をセカンダリ サイトにコピーすることを指定する SQL Server 設定オブジェクトを作成します。 このコマンドは、Configuration Manager が SQL Server Service Broker にポート 4037 を使用することを指定します。

パラメーター

-Confirm

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

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

-CopySqlServerExpressOnSecondarySite

Microsoft SQL Server Express がセカンダリ サイトにコピーされることを示します。

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-InstanceName

SQL Server のインスタンスの名前を指定します。

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

-SiteDatabaseName

Configuration Manager サイト データベースの名前を指定します。

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

-SqlServerServiceBrokerPort

SQL Server Service Broker ポートのポート番号を指定します。

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

-SqlServerServicePort

SQL Server サービス ポートのポート番号を指定します。

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

-UseExistingSqlServerInstance

SQL Server の既存のインスタンスを使用することを示します。

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

-WhatIf

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

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

入力

None

出力

IResultObject

IResultObject[]