Condividi tramite

Set-OBMachineSetting

Modulo:
MSOnlineBackup Module

Imposta un oggetto OBMachineSetting per il server.

Sintassi

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]

Descrizione

Il Set-OBMachineSetting cmdlet 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à all'utente la conferma per impostazione predefinita. Il parametro WhatIf fornisce una descrizione dettagliata delle operazioni eseguite dal cmdlet senza eseguire alcuna operazione. Il parametro Confirm consente di specificare se il cmdlet deve richiedere all'utente. L'utilizzo -Confirm:$FALSE sovrascriverà il prompt.

Per usare i cmdlet di Backup di Microsoft Azure, l'utente deve essere un amministratore del 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
$setOBMachineSettingSplat = @{
    ProxyServer   = 'http://proxycontoso.com'
    ProxyPort     = '<your proxy port>'
    ProxyUsername = 'contoso\johnj99'
    ProxyPassword = $spwd
}
Set-OBMachineSetting @setOBMachineSettingSplat

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

ESEMPIO 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

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à utilizzata da questo server.

ESEMPIO 5

Set-OBMachineSetting -NoProxy

In questo esempio viene specificato che il server non utilizza una configurazione di server proxy univoca.

ESEMPIO 6

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

In questo esempio viene registrato un server con la passphrase specificata e salvata nella posizione specificata.

ESEMPIO 7

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

In questo esempio viene registrato un server con la passphrase specificata e salvata in Azure Key Vault.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-EncryptionPassphrase

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

Proprietà dei parametri

Tipo:SecureString
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

UNNAMED_PARAMETER_SET_1
Posizione:2
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-EndWorkHour

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

Proprietà dei parametri

Tipo:TimeSpan
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

UNNAMED_PARAMETER_SET_2
Posizione:4
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-KeyVaultUri

Immettere un URI di 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).

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:3
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-NonWorkHourBandwidth

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

Proprietà dei parametri

Tipo:UInt32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

UNNAMED_PARAMETER_SET_2
Posizione:6
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-NoProxy

Specifica che le impostazioni univoche del server proxy non devono essere utilizzate per i backup in linea.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

UNNAMED_PARAMETER_SET_3
Posizione:2
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-NoThrottle

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

UNNAMED_PARAMETER_SET_4
Posizione:2
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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 recuperare i dati di backup in caso di perdita della passphrase. È necessario specificare uno dei valori PassphraseSaveLocation o KeyVaultUri (scelta consigliata).

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:2
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ProxyPassword

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

Proprietà dei parametri

Tipo:SecureString
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

UNNAMED_PARAMETER_SET_5
Posizione:5
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ProxyPort

Specifica il numero di porta da utilizzare nel server proxy.

Proprietà dei parametri

Tipo:Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

UNNAMED_PARAMETER_SET_5
Posizione:3
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ProxyServer

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

UNNAMED_PARAMETER_SET_5
Posizione:2
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ProxyUsername

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

UNNAMED_PARAMETER_SET_5
Posizione:4
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti: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>proprietà>PIN di sicurezzanella sezione Insieme di credenziali di Servizi di ripristino del portale di Azure.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:3
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-StartWorkHour

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

Proprietà dei parametri

Tipo:TimeSpan
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

UNNAMED_PARAMETER_SET_2
Posizione:3
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WorkDay

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

Proprietà dei parametri

Tipo:

DayOfWeek[]

Valore predefinito:None
Valori accettati:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

UNNAMED_PARAMETER_SET_2
Posizione:2
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WorkHourBandwidth

Specifica l'impostazione di limitazione della larghezza di banda da utilizzare per limitare la larghezza di banda di rete utilizzata dai trasferimenti di dati durante l'orario di lavoro.

Proprietà dei parametri

Tipo:UInt32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

UNNAMED_PARAMETER_SET_2
Posizione:5
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

Input

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting

Output

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting