Set-OBMachineSetting

設定伺服器的 OBMachineSetting 物件。

Syntax

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]

Description

Set-OBMachineSetting Cmdlet 會為伺服器設定 OBMachineSetting 物件,其中包含用來存取網際網路的 Proxy 伺服器設定、網路頻寬節流設定,以及將檔案解密至另一部伺服器時所需的加密複雜密碼。

此 Cmdlet 支援具有中度影響的 WhatIf 和 Confirm 參數。 中度影響表示 Cmdlet 預設不會提示使用者確認。 WhatIf 參數提供 Cmdlet 執行任何作業的詳細資訊描述。 Confirm 參數會指定 Cmdlet 是否應該提示使用者。 使用 -Confirm:$FALSE 將會覆寫提示。

若要使用 Microsoft Azure 備份 Cmdlet,使用者必須是受保護電腦上的系統管理員。

範例

範例 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

此範例會設定伺服器的 Proxy 設定。

範例 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

此範例指定此伺服器不使用唯一的 Proxy 伺服器組態。

範例 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 金鑰保存庫中。

參數

-Confirm

在執行 Cmdlet 前提示您確認。

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

輸入金鑰保存庫 URI,以安全地儲存複雜密碼。 系統會在指定的金鑰保存庫中建立新的秘密,以儲存複雜密碼。 必須指定建議的其中一個複雜密碼SaveLocation 或 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

指定不用於線上備份的唯一 Proxy 伺服器設定。

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

-NoThrottle

指定網路節流不會與線上備份搭配使用。 從本機伺服器到 Microsoft Azure 備份伺服器的備份專案資料傳輸會視需要使用頻寬。

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

-PassphraseSaveLocation

輸入可以儲存複雜密碼的網路位置或資料夾。 不建議在受保護的機器中儲存複雜密碼。 如果複雜密碼遺失,Microsoft 就無法復原備份資料。 必須指定建議的其中一個複雜密碼SaveLocation 或 KeyVaultUri (建議) 。

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

-ProxyPassword

指定要用於 Proxy 設定的驗證密碼。

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

-ProxyPort

指定要在 Proxy 伺服器上使用的埠號碼。

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

-ProxyServer

指定要在連線到 Microsoft Azure 備份 伺服器時使用的 Proxy 伺服器。

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

-ProxyUsername

指定要用於 Proxy 伺服器驗證的使用者名稱。

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

-SecurityPin

如果您要變更複雜密碼,且復原服務保存庫已開啟混合式安全性設定,則需要安全性釘選。 您必須在Azure 入口網站的 [復原服務保存庫] 區段中,選取 [設定屬性 > 安全性 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

顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。

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