Set-OBMachineSetting

模組:: MSOnlineBackup Module

為伺服器設置 OBMachineSetting 物件。

語法

UNNAMED_PARAMETER_SET_1

Set-OBMachineSetting
    [-EncryptionPassphrase] <SecureString>
    [[-SecurityPin] <String>]
    [[-PassphraseSaveLocation] <String>]
    [[-KeyVaultUri] <String>]
    [-Confirm]
    [-WhatIf]

UNNAMED_PARAMETER_SET_2

Set-OBMachineSetting
    [-WorkDay] <DayOfWeek[]>
    [-StartWorkHour] <TimeSpan>
    [-EndWorkHour] <TimeSpan>
    [-WorkHourBandwidth] <UInt32>
    [-NonWorkHourBandwidth] <UInt32>
    [-Confirm]
    [-WhatIf]

UNNAMED_PARAMETER_SET_3

Set-OBMachineSetting
    [-NoProxy]
    [-Confirm]
    [-WhatIf]

UNNAMED_PARAMETER_SET_4

Set-OBMachineSetting
    [-NoThrottle]
    [-Confirm]
    [-WhatIf]

UNNAMED_PARAMETER_SET_5

Set-OBMachineSetting
    [-ProxyServer] <String>
    [-ProxyPort] <Int32>
    [[-ProxyUsername] <String>]
    [[-ProxyPassword] <SecureString>]
    [-Confirm]
    [-WhatIf]

Description

該 Set-OBMachineSetting cmdlet 為伺服器設置一個 OBMachineSetting 物件，該物件包括用於訪問 Internet 的代理伺服器設置、網路頻寬限制設置，以及在恢復到另一台伺服器期間解密檔所需的加密密碼。

此 cmdlet 支援具有中等影響的 WhatIf 和 Confirm 參數。中等影響表示預設情況下，cmdlet 不會提示用戶進行確認。 WhatIf 參數提供了 cmdlet 在不執行任何作的情況下執行的作的詳細描述。 Confirm 參數指定 cmdlet 是否應提示使用者。 Using -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
$setOBMachineSettingSplat = @{
    ProxyServer   = 'http://proxycontoso.com'
    ProxyPort     = '<your proxy port>'
    ProxyUsername = 'contoso\johnj99'
    ProxyPassword = $spwd
}
Set-OBMachineSetting @setOBMachineSettingSplat

此範例設置伺服器的代理設置。

範例 3

$setOBMachineSettingSplat = @{
    WorkDay              = [System.DayOfWeek]::Monday, [System.DayOfWeek]::Tuesday
    StartWorkHour        = '9:00:00'
    EndWorkHour          = '18:00:00'
    WorkHourBandwidth    = (512*1024)
    NonWorkHourBandwidth = (2048*1024)
}
Set-OBMachineSetting @setOBMachineSettingSplat

此範例設定限制設置。

範例 4

Set-OBMachineSetting -NoThrottle

此範例指定此伺服器不會使用網路頻寬限制。

範例 5

Set-OBMachineSetting -NoProxy

此範例指定此伺服器不使用唯一的代理伺服器配置。

範例 6

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

此範例使用給定的密碼註冊伺服器，並將其保存在提供的位置。

範例 7

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

此示例使用給定的密碼註冊伺服器，並將其保存在 Azure Key Vault 中。

參數

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-EncryptionPassphrase

設置用於加密備份數據的加密密碼。

參數屬性

類型:	SecureString
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

UNNAMED_PARAMETER_SET_1

Position:	2
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-EndWorkHour

指定結束工作時間範圍的小時數。

參數屬性

類型:	TimeSpan
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

UNNAMED_PARAMETER_SET_2

Position:	4
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-KeyVaultUri

輸入 Key Vault URI 以安全地保存密碼。將在指定的金鑰保管庫中創建新金鑰，以保存密碼。需要指定 PassphraseSaveLocation 或 KeyVaultUri （recommended）之一。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	3
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-NonWorkHourBandwidth

指定頻寬限制設置，用於限制非工作時間數據傳輸所消耗的網路頻寬。

參數屬性

類型:	UInt32
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

UNNAMED_PARAMETER_SET_2

Position:	6
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-NoProxy

指定唯一代理伺服器設置不用於連線備份。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

UNNAMED_PARAMETER_SET_3

Position:	2
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-NoThrottle

指定網路限制不用於連線備份。將備份項從本地伺服器傳輸到 Microsoft Azure 備份伺服器將根據需要使用頻寬。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

UNNAMED_PARAMETER_SET_4

Position:	2
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-PassphraseSaveLocation

輸入可以保存密碼的網路位置或資料夾。不建議將密碼保存在受保護的計算機中。如果密碼丟失，Microsoft 將無法恢復備份數據。需要指定 PassphraseSaveLocation 或 KeyVaultUri （recommended）之一。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	2
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-ProxyPassword

指定要用於代理設置的認證密碼。

參數屬性

類型:	SecureString
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

UNNAMED_PARAMETER_SET_5

Position:	5
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-ProxyPort

指定要在 Proxy Server 上使用的埠號。

參數屬性

類型:	Int32
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

UNNAMED_PARAMETER_SET_5

Position:	3
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-ProxyServer

指定連接到 Microsoft Azure 備份伺服器時要使用的代理伺服器。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

UNNAMED_PARAMETER_SET_5

Position:	2
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ProxyUsername

指定要用於代理伺服器身份驗證的使用者名。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

UNNAMED_PARAMETER_SET_5

Position:	4
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-SecurityPin

如果要更改密碼，並且為恢復服務保管庫啟用了混合安全設置，則需要安全 PIN。必須通過在 Azure 門戶的「恢復服務保管庫」部分的「設置>屬性>」下選擇“生成”來生成安全 PIN。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	3
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-StartWorkHour

指定開始工作時間範圍的小時。

參數屬性

類型:	TimeSpan
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

UNNAMED_PARAMETER_SET_2

Position:	3
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。該 Cmdlet 未被執行。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WorkDay

使用 using [DayOfWeek] 系統變數指定工作日陣列。

參數屬性

類型:	DayOfWeek[]
預設值:	None
接受的值:	Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
支援萬用字元:	False
不要顯示:	False

參數集

UNNAMED_PARAMETER_SET_2

Position:	2
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WorkHourBandwidth

指定頻寬限制設置，用於限制工作時間數據傳輸所消耗的網路頻寬。

參數屬性

類型:	UInt32
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

UNNAMED_PARAMETER_SET_2

Position:	5
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

共用方式為

Set-OBMachineSetting

語法

UNNAMED_PARAMETER_SET_1

UNNAMED_PARAMETER_SET_2

UNNAMED_PARAMETER_SET_3

UNNAMED_PARAMETER_SET_4

UNNAMED_PARAMETER_SET_5

Description

範例

範例 1

範例 2

範例 3

範例 4

範例 5

範例 6

範例 7

參數

-Confirm

參數屬性

參數集

-EncryptionPassphrase

參數屬性

參數集

-EndWorkHour

參數屬性

參數集

-KeyVaultUri

參數屬性

參數集

-NonWorkHourBandwidth

參數屬性

參數集

-NoProxy

參數屬性

參數集

-NoThrottle

參數屬性

參數集

-PassphraseSaveLocation

參數屬性

參數集

-ProxyPassword

參數屬性

參數集

-ProxyPort

參數屬性

參數集

-ProxyServer

參數屬性

參數集

-ProxyUsername

參數屬性

參數集

-SecurityPin

參數屬性

參數集

-StartWorkHour

參數屬性

參數集

-WhatIf

參數屬性

參數集

-WorkDay

參數屬性

參數集

-WorkHourBandwidth

參數屬性

參數集

輸入

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting

輸出

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting

相關連結