Partager via

Set-OBMachineSetting

Module:
MSOnlineBackup Module

Définit un objet OBMachineSetting pour le serveur.

Syntaxe

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

L’applet Set-OBMachineSetting de commande définit un objet OBMachineSetting pour le serveur, qui inclut les paramètres du serveur proxy pour l’accès à Internet, les paramètres de limitation de la bande passante réseau et la phrase secrète de chiffrement requise pour déchiffrer les fichiers lors de la récupération vers un autre serveur.

Cette applet de commande prend en charge les paramètres WhatIf et Confirm avec un impact moyen. L’impact moyen signifie que l’applet de commande n’invite pas l’utilisateur à confirmer par défaut. Le paramètre WhatIf donne une description détaillée de ce que fait l’applet de commande sans effectuer d’opération. Le paramètre Confirm spécifie si l’applet de commande doit inviter l’utilisateur. Using -Confirm:$FALSE remplacera l’invite.

Pour utiliser les applets de commande Microsoft Azure Backup, l’utilisateur doit être un administrateur sur l’ordinateur protégé.

Exemples

EXEMPLE 1

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

Cet exemple définit la phrase secrète de chiffrement pour un ordinateur.

EXEMPLE 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

Cet exemple définit les paramètres de proxy d’un serveur.

EXEMPLE 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

Cet exemple définit les paramètres de limitation.

EXEMPLE 4

Set-OBMachineSetting -NoThrottle

Cet exemple spécifie que la limitation de la bande passante réseau ne sera pas utilisée par ce serveur.

EXEMPLE 5

Set-OBMachineSetting -NoProxy

Cet exemple spécifie que ce serveur n’utilise pas une configuration de serveur proxy unique.

EXEMPLE 6

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

Cet exemple enregistre un serveur avec la phrase de passe donnée et l’enregistre à l’emplacement fourni.

EXEMPLE 7

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

Cet exemple inscrit un serveur avec la phrase secrète donnée et l’enregistre dans Azure Key Vault.

Paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-EncryptionPassphrase

Définit la phrase secrète de chiffrement à utiliser pour chiffrer les données sauvegardées.

Propriétés du paramètre

Type:SecureString
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

UNNAMED_PARAMETER_SET_1
Position:2
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-EndWorkHour

Spécifie l’heure qui met fin à la plage d’heures de travail.

Propriétés du paramètre

Type:TimeSpan
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

UNNAMED_PARAMETER_SET_2
Position:4
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-KeyVaultUri

Entrez un URI Key Vault pour enregistrer la phrase secrète en toute sécurité. Un nouveau secret est créé dans le coffre de clés spécifié pour enregistrer la phrase secrète. L’un des PassphraseSaveLocation ou KeyVaultUri (recommandé) doit être spécifié.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:3
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-NonWorkHourBandwidth

Spécifie le paramètre de limitation de la bande passante à utiliser pour limiter la bande passante réseau consommée par les transferts de données en dehors des heures de travail.

Propriétés du paramètre

Type:UInt32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

UNNAMED_PARAMETER_SET_2
Position:6
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-NoProxy

Spécifie que les paramètres de serveur proxy uniques ne doivent pas être utilisés pour les sauvegardes en ligne.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

UNNAMED_PARAMETER_SET_3
Position:2
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-NoThrottle

Spécifie que la limitation du réseau n’est pas utilisée avec les sauvegardes en ligne. Les transferts de données des éléments sauvegardés du serveur local vers le serveur de sauvegarde Microsoft Azure utilisent la bande passante selon les besoins.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

UNNAMED_PARAMETER_SET_4
Position:2
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PassphraseSaveLocation

Entrez un emplacement réseau ou un dossier dans lequel la phrase de passe peut être enregistrée. Il n’est pas recommandé d’enregistrer la phrase secrète dans l’ordinateur protégé. Microsoft ne peut pas récupérer les données de sauvegarde si la phrase de passe est perdue. L’un des PassphraseSaveLocation ou KeyVaultUri (recommandé) doit être spécifié.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:2
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ProxyPassword

Spécifie le mot de passe d’authentification à utiliser pour le paramètre de proxy.

Propriétés du paramètre

Type:SecureString
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

UNNAMED_PARAMETER_SET_5
Position:5
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ProxyPort

Spécifie le numéro de port à utiliser sur le serveur proxy.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

UNNAMED_PARAMETER_SET_5
Position:3
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ProxyServer

Spécifie le serveur proxy à utiliser lors de la connexion au serveur de sauvegarde Microsoft Azure.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

UNNAMED_PARAMETER_SET_5
Position:2
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ProxyUsername

Spécifie le nom d’utilisateur à utiliser pour l’authentification du serveur proxy.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

UNNAMED_PARAMETER_SET_5
Position:4
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-SecurityPin

Le code PIN de sécurité est nécessaire si vous modifiez la phrase secrète et que le paramètre de sécurité hybride est activé pour le coffre-fort Recovery Services. Vous devez générer un code PIN de sécurité en sélectionnant Générer sous Paramètres>Propriétés Code>PIN de sécuritédans la section Coffre Recovery Services du portail Azure.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:3
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-StartWorkHour

Spécifie l’heure qui commence la plage d’heures de travail.

Propriétés du paramètre

Type:TimeSpan
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

UNNAMED_PARAMETER_SET_2
Position:3
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WorkDay

Spécifie le tableau des jours ouvrables à l’aide des variables système d’utilisation [DayOfWeek] .

Propriétés du paramètre

Type:

DayOfWeek[]

Valeur par défaut:None
Valeurs acceptées:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

UNNAMED_PARAMETER_SET_2
Position:2
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WorkHourBandwidth

Spécifie le paramètre de limitation de la bande passante à utiliser pour limiter la bande passante réseau consommée par les transferts de données pendant les heures de travail.

Propriétés du paramètre

Type:UInt32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

UNNAMED_PARAMETER_SET_2
Position:5
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

Entrées

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting

Sorties

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting