Condividi tramite

Set-OBMachineSetting

  • Riferimento
Modulo:
MSOnlineBackup

Imposta un oggetto OBMachineSetting per il server.

Sintassi

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]

Descrizione

Il cmdlet Set-OBMachineSetting imposta un oggetto OBMachineSetting per il server che include le impostazioni del server proxy per l'accesso a Internet, le impostazioni di limitazione della larghezza di banda di rete e la passphrase di crittografia necessaria per decrittografare i file durante il ripristino in un altro server.

Questo cmdlet supporta i parametri WhatIf e Confirm con un impatto medio. L'impatto medio indica che il cmdlet non richiederà conferma all'utente per impostazione predefinita. Il parametro WhatIf fornisce una descrizione dettagliata delle operazioni eseguite dal cmdlet senza eseguire alcuna operazione. Il parametro Confirm specifica se il cmdlet deve richiedere all'utente. L'uso di -Confirm:$FALSE sostituirà il prompt.

Per usare i cmdlet di Microsoft Backup di Azure, l'utente deve essere un amministratore nel computer protetto.

Esempio

ESEMPIO 1

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

In questo esempio viene impostata la passphrase di crittografia per un computer.

ESEMPIO 2

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



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

In questo esempio vengono impostate le impostazioni proxy per un server.

ESEMPIO 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)

In questo esempio vengono impostate le impostazioni di limitazione.

ESEMPIO 4

Set-OBMachineSetting -NoThrottle

In questo esempio viene specificato che la limitazione della larghezza di banda di rete non verrà usata da questo server.

ESEMPIO 5

Set-OBMachineSetting -NoProxy

In questo esempio viene specificato che questo server non usa una configurazione univoca del server proxy.

ESEMPIO 6

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

Questo esempio registra un server con la passphrase specificata e lo salva nella posizione specificata.

ESEMPIO 7

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

Questo esempio registra un server con la passphrase specificata e lo salva in Azure Key Vault.

Parametri

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EncryptionPassphrase

Imposta la passphrase di crittografia da utilizzare per crittografare i dati di cui è stato eseguito il backup.

Tipo:SecureString
Posizione:2
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-EndWorkHour

Specifica l'ora che termina l'intervallo di ore lavorative.

Tipo:TimeSpan
Posizione:4
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-KeyVaultUri

Immettere un URI Key Vault per salvare la passphrase in modo sicuro. Viene creato un nuovo segreto nell'insieme di credenziali delle chiavi specificato per salvare la passphrase. È necessario specificare uno dei valori PassphraseSaveLocation o KeyVaultUri (scelta consigliata).

Tipo:String
Posizione:3
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-NonWorkHourBandwidth

Specifica l'impostazione di limitazione della larghezza di banda da usare per limitare la larghezza di banda di rete utilizzata dai trasferimenti di dati durante le ore non lavorative.

Tipo:UInt32
Posizione:6
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-NoProxy

Specifica che le impostazioni univoche del server proxy non devono essere usate per i backup online.

Tipo:SwitchParameter
Posizione:2
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NoThrottle

Specifica che la limitazione della rete non viene usata con i backup online. I trasferimenti di dati degli elementi di cui è stato eseguito il backup dal server locale al server Microsoft Backup di Azure useranno la larghezza di banda in base alle esigenze.

Tipo:SwitchParameter
Posizione:2
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassphraseSaveLocation

Immettere un percorso di rete o una cartella in cui è possibile salvare la passphrase. Non è consigliabile salvare la passphrase nel computer protetto. Microsoft non è in grado di ripristinare i dati di backup se la passphrase viene persa. È necessario specificare uno dei valori PassphraseSaveLocation o KeyVaultUri (scelta consigliata).

Tipo:String
Posizione:2
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ProxyPassword

Specifica la password di autenticazione da usare per l'impostazione del proxy.

Tipo:SecureString
Posizione:5
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ProxyPort

Specifica il numero di porta da utilizzare nel server proxy.

Tipo:Int32
Posizione:3
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ProxyServer

Specifica il server proxy da utilizzare per la connessione al server microsoft Backup di Azure.

Tipo:String
Posizione:2
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ProxyUsername

Specifica il nome utente da utilizzare per l'autenticazione del server proxy.

Tipo:String
Posizione:4
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SecurityPin

Il pin di sicurezza è necessario se si modifica la passphrase e l'impostazione di sicurezza ibrida è attivata per l'insieme di credenziali di Servizi di ripristino. È necessario generare un pin di sicurezza selezionando Genera in Impostazioni > Pin di sicurezza delle proprietà > nella sezione Insieme di credenziali di Servizi di ripristino del portale di Azure.

Tipo:String
Posizione:named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-StartWorkHour

Specifica l'ora che avvia l'intervallo di ore lavorative.

Tipo:TimeSpan
Posizione:3
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WorkDay

Specifica la matrice di giorni lavorativi usando le variabili di sistema [DayOfWeek].

Tipo:DayOfWeek[] {Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday}
Posizione:2
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WorkHourBandwidth

Specifica l'impostazione di limitazione della larghezza di banda da usare per limitare la larghezza di banda di rete utilizzata dai trasferimenti di dati durante le ore lavorative.

Tipo:UInt32
Posizione:5
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting

Output

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting