Set-OBMachineSetting

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.

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

-EncryptionPassphrase

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

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

-EndWorkHour

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

Type:TimeSpan
Position:4
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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).

Type:String
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-NoProxy

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

Type:SwitchParameter
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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).

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

-ProxyPassword

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

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

-ProxyPort

Specifica il numero di porta da utilizzare nel server proxy.

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

-ProxyServer

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

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

-ProxyUsername

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

Type:String
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-StartWorkHour

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

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

-WhatIf

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

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

-WorkDay

Specifica la matrice di giorni lavorativi usando le variabili di sistema [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

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.

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

Input

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting

Output

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting