Set-SmaAdminConfiguration
SMA の管理構成設定を変更します。
構文
Set-SmaAdminConfiguration
[-Telemetry <Boolean>]
[-DrainTimeInSeconds <Int32>]
[-ScriptExecutionPolicy <String>]
[-MaxJobRecords <Int32>]
[-PurgeJobsOlderThanCountDays <Int32>]
[-Force]
[-ChartTimeSliceSampleSize <ChartTimeSliceSampleSize>]
-WebServiceEndpoint <String>
[-Port <Int32>]
[-AuthenticationType <String>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
Set-SmaAdminConfiguration コマンドレットは、Service Management Automation (SMA) の管理構成設定を変更します。 Web サービス エンドポイントと必要に応じてポートを指定します。
このコマンドレットを使用して、次の設定を構成します。
- 診断データと使用状況データを Microsoft と共有するかどうか
- ドレイン時間
- スクリプト実行ポリシー
- グラフのタイム スライスのサンプル サイズ
- 最も古いジョブを消去する前に格納する最大ジョブ レコード
- 消去される前のジョブの最大有効期間
例
例 1: 管理構成設定を変更する
PS C:\> Set-SmaAdminConfiguration -WebServiceEndpoint "https://contoso.com/app01" -DrainTimeInSeconds 60このコマンドは、ドレイン時間を 60 秒に設定します。
パラメーター
-AuthenticationType
認証の種類を指定します。 有効な値は次のとおりです。
- Basic
- Windows
このパラメーターの既定値は Windows です。 基本認証を使用する場合は、 Credential パラメーターを使用して資格情報を指定する必要があります。
| Type: | String |
| Accepted values: | Basic, Windows |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ChartTimeSliceSampleSize
グラフのタイム スライスのサンプル サイズを指定します。 有効な値は次のとおりです。
- Small
- Medium
- Large
- ExtraLarge
| Type: | ChartTimeSliceSampleSize |
| Accepted values: | Small, Medium, Large, ExtraLarge |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
SMA Web サービスへの接続の PSCredential オブジェクトを指定します。
資格情報オブジェクトを取得するには、Get-Credential コマンドレットを使用します。
詳細を表示するには「Get-Help Get-Credential」を入力します。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DrainTimeInSeconds
Runbook worker サービスの停止が開始された後、Runbook worker ホストが実行中のジョブを終了する時間を秒単位で指定します。 ホストのドレイン中、既存のジョブには、指定されたドレイン時間 (秒) が指定され、自然に中断または終了され、新しいジョブは受け入れされません。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
ユーザーに確認せずに、直ちにコマンドを実行します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxJobRecords
保持されるジョブ レコードの最大数を指定します。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Port
SMA Web サービスのポート番号を指定します。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PurgeJobsOlderThanCountDays
ジョブ履歴が保持される日数を指定します。 この値より古いジョブは消去されます。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScriptExecutionPolicy
ワーカー ホスト上の Runbook ジョブのWindows PowerShell実行ポリシーを決定します。
実行ポリシーの詳細については、「.」と入力します Get-Help about_Execution_Policies。
このパラメーターの有効な値は次のとおりです。
- 制限付き : スクリプトを実行することはできません。 Windows PowerShellは対話型モードでのみ使用できます。
- AllSigned。 信頼できる発行元によって署名されたスクリプトのみを実行できます。
- RemoteSigned。 スクリプトを実行するには、ダウンロードしたスクリプトに信頼できる発行元が署名する必要があります。
- Unrestricted。 制限なし。すべてのWindows PowerShellスクリプトを実行できます。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Telemetry
診断データと使用状況データを Microsoft と共有するかどうかを示します。 このパラメーターの有効値は、次のとおりです。
- $true。 診断データと使用状況データを Microsoft と共有します。
- $false。 診断データと使用状況データを Microsoft と共有しないでください。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WebServiceEndpoint
SMA Web サービスのエンドポイントを URL として指定します。 プロトコル (http:// や https:// など) を含める必要があります。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |