Set-OBMachineSetting

  • リファレンス
モジュール:
MSOnlineBackup

サーバーの OBMachineSetting オブジェクトを設定します。

構文

Set-OBMachineSetting
   [-EncryptionPassphrase] <SecureString>
   [[-SecurityPin] <String>][[-PassphraseSaveLocation] <String>]
   [[-KeyVaultUri] <String>]
   [-Confirm]
   [-WhatIf]
Set-OBMachineSetting
   [-WorkDay] <DayOfWeek[] {Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday}>
   [-StartWorkHour] <TimeSpan>
   [-EndWorkHour] <TimeSpan>
   [-WorkHourBandwidth] <UInt32>
   [-NonWorkHourBandwidth] <UInt32>
   [-Confirm]
   [-WhatIf]
Set-OBMachineSetting
   [-NoProxy]
   [-Confirm]
   [-WhatIf]
Set-OBMachineSetting
   [-NoThrottle]
   [-Confirm]
   [-WhatIf]
Set-OBMachineSetting
   [-ProxyServer] <String>
   [-ProxyPort] <Int32>
   [[-ProxyUsername] <String>]
   [[-ProxyPassword] <SecureString>]
   [-Confirm]
   [-WhatIf]

説明

Set-OBMachineSetting コマンドレットは、インターネットにアクセスするためのプロキシ サーバー設定、ネットワーク帯域幅調整設定、および別のサーバーへの回復中にファイルの暗号化を解除するために必要な暗号化パスフレーズを含む、サーバーの OBMachineSetting オブジェクトを設定します。

このコマンドレットは、影響が中程度の WhatIf パラメーターと Confirm パラメーターをサポートしています。 中程度の影響は、コマンドレットが既定でユーザーに確認を求めないことを示します。 WhatIf パラメーターは、操作を実行せずにコマンドレットが実行する内容の詳細な説明を提供します。 Confirm パラメーターは、コマンドレットでユーザーにプロンプトを表示するかどうかを指定します。 -Confirm:$FALSE を使用すると、プロンプトがオーバーライドされます。

Microsoft Azure Backup コマンドレットを使用するには、ユーザーが保護されたコンピューターの管理者である必要があります。

例

例 1

$spwd = ConvertTo-SecureString -String Notag00pa55word -AsPlainText -Force 
Set-OBMachineSetting -EncryptionPassphrase $spwd -PassphraseSaveLocation C:\

次の使用例は、コンピューターの暗号化パスフレーズを設定します。

例 2

$spwd = ConvertTo-SecureString -String Notag00pa55word -AsPlainText -Force



Set-OBMachineSetting -ProxyServer http://proxycontoso.com -ProxyPort <your proxy port> -ProxyUsername contoso\johnj99 -ProxyPassword $spwd

次の使用例は、サーバーのプロキシ設定を設定します。

例 3

$mon = [System.DayOfWeek]::Monday



$tue = [System.DayOfWeek]::Tuesday



Set-OBMachineSetting -WorkDay $mon, $tue -StartWorkHour "9:00:00" -EndWorkHour "18:00:00" -WorkHourBandwidth (512*1024) -NonWorkHourBandwidth (2048*1024)

次の使用例は、調整設定を設定します。

例 4

Set-OBMachineSetting -NoThrottle

この例では、このサーバーでネットワーク帯域幅の調整を使用しないことを指定します。

例 5

Set-OBMachineSetting -NoProxy

この例では、このサーバーが一意のプロキシ サーバー構成を使用しないことを指定します。

例 6

$spwd = ConvertTo-SecureString -String abcdefgh123456000345 -AsPlainText -Force
Set-OBMachineSetting -EncryptionPassphrase $spwd -SecurityPIN 123456 -PassphraseSaveLocation "C:\Users\myuser\MyFolder \Desktop\passphrases\"

次の使用例は、指定されたパスフレーズを使用してサーバーを登録し、指定された場所に保存します。

例 7

$spwd = ConvertTo-SecureString -String abcdefgh123456000345 -AsPlainText -Force
Set-OBMachineSetting -EncryptionPassphrase $spwd -SecurityPIN 123456 -KeyVaultUri "https://mykeyvault.vault.azure.net/"

この例では、指定したパスフレーズを使用してサーバーを登録し、Azure Key Vaultに保存します。

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

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

-EncryptionPassphrase

バックアップされたデータの暗号化に使用する暗号化パスフレーズを設定します。

Type:SecureString
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-EndWorkHour

作業時間の範囲を終了する時間を指定します。

Type:TimeSpan
Position:4
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-KeyVaultUri

パスフレーズを安全に保存するには、Key Vault URI を入力します。 パスフレーズを保存するために、指定されたキー コンテナーに新しいシークレットが作成されます。 PassphraseSaveLocation または KeyVaultUri (推奨) のいずれかを指定する必要があります。

Type:String
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-NonWorkHourBandwidth

勤務時間外のデータ転送で使用されるネットワーク帯域幅を制限するために使用する帯域幅調整設定を指定します。

Type:UInt32
Position:6
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoProxy

一意のプロキシ サーバー設定をオンライン バックアップに使用しないことを指定します。

Type:SwitchParameter
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NoThrottle

ネットワーク調整がオンライン バックアップで使用されないことを指定します。 ローカル サーバーから Microsoft Azure Backup サーバーへのバックアップされたアイテムのデータ転送では、必要に応じて帯域幅が使用されます。

Type:SwitchParameter
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PassphraseSaveLocation

パスフレーズを保存できるネットワークの場所またはフォルダーを入力します。 保護されているマシンにパスフレーズを保存することはお勧めしません。 パスフレーズが失われた場合、Microsoft はバックアップ データを回復できません。 PassphraseSaveLocation または KeyVaultUri (推奨) のいずれかを指定する必要があります。

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ProxyPassword

プロキシ設定に使用する認証パスワードを指定します。

Type:SecureString
Position:5
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ProxyPort

プロキシ サーバーで使用するポート番号を指定します。

Type:Int32
Position:3
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ProxyServer

Microsoft Azure Backup サーバーに接続するときに使用するプロキシ サーバーを指定します。

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ProxyUsername

プロキシ サーバー認証に使用するユーザー名を指定します。

Type:String
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SecurityPin

パスフレーズを変更していて、Recovery Services コンテナーのハイブリッド セキュリティ設定が有効になっている場合は、セキュリティ ピンが必要です。 セキュリティ ピンを生成するには、Azure portalの [Recovery Services コンテナー] セクションの [設定>プロパティ>] [セキュリティ PIN] で [生成] を選択する必要があります。

Type:String
Position:named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-StartWorkHour

勤務時間の範囲を開始する時間を指定します。

Type:TimeSpan
Position:3
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

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

-WorkDay

[DayOfWeek] システム変数を使用して、稼働日の配列を指定します。

Type:DayOfWeek[] {Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday}
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WorkHourBandwidth

勤務時間中にデータ転送によって消費されるネットワーク帯域幅を制限するために使用する帯域幅調整設定を指定します。

Type:UInt32
Position:5
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

入力

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting

出力

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting