Flash info

"Les IT Pros sont en train de migrer rapidement car PowerShell est plus facile et plus puissant que VBScript."

Microsoft Scripting Guys

 
Accueil arrow Aide mémoire arrow Convert* - *
Aide mémoire - Convert
Écrit par Arnaud Petitjean [MVP]   
10-12-2006
ConvertFrom-SecureString Convert-Path
ConvertTo-Html ConvertTo-SecureString



NOM
    ConvertFrom-SecureString
   
RÉSUMÉ
    Convertit une chaîne sécurisée en chaîne standard chiffrée.
   
   
SYNTAXE
    ConvertFrom-SecureString [-secureString] <SecureString> [[-secureKey] <SecureString>] [<CommonParameters>]
   
    ConvertFrom-SecureString [-secureString] <SecureString> [-key <Byte[]>] [<CommonParameters>]
   
   
DESCRIPTION DÉTAILLÉE
    Convertit une chaîne sécurisée (System.Security.SecureString) en chaîne standard chiffrée (System.String). Contrairement à une chaîne sécurisée, la chaîne standard chiffrée peut être enregistrée dans un fichier pour une utilisation ultérieure. La chaîne standard chiffrée peut être reconvertie vers son format de chaîne sécurisée en utilisant l'applet de commande ConvertTo-SecureString. Si une clé de chiffrement est explicitement spécifiée au moyen des paramètres Key ou SecureKey, l'algorithme de chiffrement Rijndael est utilisé. La clé spécifiée doit avoir une longueur de 128, 192 ou 256 bits, car ces longueurs sont celles qu'autorise l'algorithme de chiffrement Rijndael. Si aucune clé n'est spécifiée, c'est l'API de protection des données (DPAPI) Windows qui est utilisée pour chiffrer la représentation sous forme de chaîne standard.
   

PARAMÈTRES
    -secureString <SecureString>
        Spécifie la chaîne sécurisée à convertir en chaîne standard chiffrée.
       
    -secureKey <SecureString>
        Spécifie la clé de chiffrement en tant que chaîne sécurisée. La valeur de la chaîne sécurisée est convertie en tableau d'octets avant d'être utilisée comme clé.
       
    -key <Byte[]>
        Spécifie la clé de chiffrement en tant que tableau d'octets.
       
    <CommonParameters>
        Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug,
        -ErrorAction, -ErrorVariable et -OutVariable. Pour plus d'informations,
        tapez « get-help about_commonparameters ».
   
    -------------------------- EXEMPLE 1 --------------------------
   
    C:\PS>$securestring = read-host -assecurestring
   
    Cette commande vous permet de créer une chaîne sécurisée au moyen de l'invite de commandes. Après avoir entré la commande, tapez la chaîne que vous souhaitez stocker en tant que chaîne sécurisée. Un astérisque (*) s'affiche en réponse à chaque caractère que vous tapez.
   
   
   
   
    -------------------------- EXEMPLE 2 --------------------------
   
    C:\PS>$standardstring = convertfrom-securestring  $securestring
   
    Cette commande convertit une chaîne sécurisée stockée dans la variable $securestring en chaîne standard chiffrée. La chaîne standard chiffrée obtenue est stockée dans la variable $standardstring et peut être affichée en tapant $standardstring.
   
   
   
   
    -------------------------- EXEMPLE 3 --------------------------
   
    C:\PS>$key = (3,4,2,3,56,34,254,222,1,1,2,23,42,54,33,233,1,34,2,7,6,5,35,43)
    $standardstring = convertfrom-securestring  $securestring -key $key
   
    Cette commande convertit une chaîne sécurisée stockée dans la variable $securestring en chaîne standard à l'aide de l'algorithme Rijndael avec une clé de 192 bits. La chaîne standard chiffrée obtenue est stockée dans la variable $standardstring et peut être affichée en tapant $standardstring. La clé est stockée dans la variable $key et passée à l'applet de commande en tant que valeur du paramètre Key. La clé est un tableau de 24 chiffres, tous inférieurs à 256. Ils sont au nombre de 24, car chacun représente un octet (8 bits) et 8 bits*24 = 192 bits, ce qui représente une longueur de clé valide pour l'algorithme Rijndael. Chaque valeur est inférieure à 256, valeur maximale pouvant être stockée dans un octet non signé.
   
   
   
   
REMARQUES
    Pour plus d'informations, tapez : "get-help ConvertFrom-SecureString -detailed".
    Pour obtenir des informations techniques, tapez : "get-help ConvertFrom-SecureString -full".


NOM
    Convert-Path
   
RÉSUMÉ
    Convertit un chemin d'accès Windows PowerShell en chemin d'accès à un fournisseur de Windows PowerShell.
   
   
SYNTAXE
    Convert-Path [-path] <string[]> [<CommonParameters>]
   
    Convert-Path [-literalPath] <string[]> [<CommonParameters>]
   
   
DESCRIPTION DÉTAILLÉE
    Convertit un chemin d'accès Windows PowerShell en chemin d'accès à un fournisseur de Windows PowerShell.
   

PARAMÈTRES
    -path <string[]>
        Spécifie le chemin d'accès Windows PowerShell à convertir.
       
    -literalPath <string[]>
        Spécifie le chemin d'accès à convertir. La valeur de -LiteralPath est utilisée exactement telle que vous la tapez. Aucun caractère n'est interprété en tant que caractère générique. Si le chemin d'accès inclut des caractères d'échappement, mettez-le entre des guillemets simples. Les guillemets simples indiquent à Windows PowerShell qu'aucun caractère ne doit être interprété en tant que séquence d'échappement.
       
    <CommonParameters>
        Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug,
        -ErrorAction, -ErrorVariable et -OutVariable. Pour plus d'informations,
        tapez « get-help about_commonparameters ».
   
    -------------------------- EXEMPLE 1 --------------------------
   
    C:\PS>convert-path ~
   
    Cette commande développe le répertoire de travail actif.
   
   
   
   
    -------------------------- EXEMPLE 2 --------------------------
   
    C:\PS>convert-path HKLM:\software\microsoft
   
    Cette commande convertit le chemin d'accès au fournisseur de Windows PowerShell en chemin d'accès standard au Registre.
   
   
   
   
REMARQUES
    Pour plus d'informations, tapez : "get-help Convert-Path -detailed".
    Pour obtenir des informations techniques, tapez : "get-help Convert-Path -full".


NOM
    ConvertTo-Html
   
RÉSUMÉ
    Crée une page HTML qui représente un objet ou un jeu d'objets.
   
   
SYNTAXE
    ConvertTo-Html [[-property] <Object[]>] [-inputObject <psobject>] [-body <string[]>] [-head <string[]>] [-title <string>] [<CommonParameters>]
   
   
DESCRIPTION DÉTAILLÉE
    Crée une page HTML qui représente des objets. L'applet de commande retourne une page HTML complète. Les objets d'entrée sont représentés dans un tableau HTML seul dans cette page. Les noms de propriété d'objet apparaissent comme en-têtes de colonne dans le tableau HTML et chacune des lignes du tableau contient les valeurs de propriété correspondantes. Les propriétés sans valeurs sont représentées comme cellules vides dans le tableau.
   

PARAMÈTRES
    -inputObject <psobject>
        Spécifie les objets à représenter comme un tableau HTML. Entrez une variable contenant les objets ou tapez une commande ou une expression qui obtient les objets.
       
    -property <Object[]>
        Spécifie les propriétés de l'objet d'entrée à représenter dans le tableau HTML.
       
    -body <string[]>
        Spécifie le texte à inclure dans l'élément <body> de la sortie HTML.
       
    -head <string[]>
        Spécifie le texte à inclure dans l'élément <head> de la sortie HTML.
       
    -title <string>
        Spécifie le texte à inclure dans l'élément <title> de la sortie HTML.
       
    <CommonParameters>
        Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug,
        -ErrorAction, -ErrorVariable et -OutVariable. Pour plus d'informations,
        tapez « get-help about_commonparameters ».
   
    -------------------------- EXEMPLE 1 --------------------------
   
    C:\PS>get-date | convertto-html
   
    Cette commande utilise l'applet de commande Get-Date pour créer un objet DateTime et le diriger vers l'applet de commande ConvertTo-HTML. L'applet de commande crée une page HTML qui contient un tableau HTML représentant l'objet. La sortie HTML est affichée sur la console
   
   
   
   
    -------------------------- EXEMPLE 2 --------------------------
   
    C:\PS>get-date | convertto-html -title "Date Table" |
    foreach { $_ -replace "><",">`n<" }
   
    Cette commande utilise l'applet de commande Get-Date pour créer l'objet DateTime. Elle dirige le résultat vers l'applet de commande ConvertTo-HTML. Les instructions de mise en forme sont appliquées via l'applet de commande foreach-object. Elle crée un jeu de balises pour chaque valeur dans l'objet DateTime.
   
   
   
   
    -------------------------- EXEMPLE 3 --------------------------
   
    C:\PS>get-process | convertto-html -properties Name,Path,Company '
    -title "Process Information" > proc.htm
    invoke-item proc.htm
   
    Cette commande utilise l'applet de commande Get-Process pour récupérer un jeu d'objets qui contiennent des informations sur les processus s'exécutant sur l'ordinateur. Elle dirige ces objets vers l'applet de commande de ConvertTo-HTML, qui crée une page HTML contenant un tableau HTML qui représente les objets. Le paramètre Properties est utilisé pour spécifier les propriétés des objets qui sont représentés dans le tableau. Le paramètre Title spécifie le titre de la page HTML. L'opérateur de redirection (>) est utilisé pour envoyer le HTML résultant à un fichier nommé proc.htm. Enfin, l'applet de commande Invoke-Item est utilisée pour ouvrir le fichier proc.htm dans l'application associée à l'extension de nom de fichier .htm.
   
   
   
   
REMARQUES
    Pour plus d'informations, tapez : "get-help ConvertTo-Html -detailed".
    Pour obtenir des informations techniques, tapez : "get-help ConvertTo-Html -full".


NOM
    ConvertTo-SecureString
   
RÉSUMÉ
    Convertit des chaînes standard chiffrées en chaînes sécurisées. Cette commande peut aussi convertir du texte brut en chaînes sécurisées. Elle est utilisée avec ConvertFrom-SecureString et Read-Host.
   
   
SYNTAXE
    ConvertTo-SecureString [-string] <string> [[-secureKey] <SecureString>] [<CommonParameters>]
   
    ConvertTo-SecureString [-string] <string> [-key <Byte[]>] [<CommonParameters>]
   
    ConvertTo-SecureString [-string] <string> [[-asPlainText]] [[-force]] [<CommonParameters>]
   
   
DESCRIPTION DÉTAILLÉE
    Convertit des chaînes standard chiffrées en chaînes sécurisées. Cette commande peut aussi convertir du texte brut en chaînes sécurisées. Elle est utilisée avec ConvertFrom-SecureString et Read-Host. La chaîne sécurisée créée par l'applet de commande peut être utilisée avec des applets de commande ou des fonctions qui requièrent un paramètre de type SecureString. La chaîne sécurisée peut être reconvertie en chaîne standard chiffrée en utilisant l'applet de commande ConvertFrom-SecureString. Cela permet son stockage dans un fichier pour une utilisation ultérieure.
   
    Si la chaîne standard en cours de conversion a été chiffrée avec ConvertFrom-SecureString et la spécification d'une clé, cette clé doit être fournie comme valeur du paramètre Key ou SecureKey de l'applet de commande ConvertTo-SecureString.
   

PARAMÈTRES
    -string <string>
        Spécifie la chaîne à convertir en chaîne sécurisée.
       
    -secureKey <SecureString>
        Spécifie la clé de chiffrement à utiliser lors de la conversion d'une chaîne sécurisée en chaîne standard chiffrée. La clé doit être fournie sous forme de chaîne sécurisée. La chaîne sécurisée est convertie en tableau d'octets avant d'être utilisée comme clé. Les longueurs de clé valides sont 16, 24 et 32 octets.
       
    -key <Byte[]>
        Spécifie la clé de chiffrement à utiliser lors de la conversion d'une chaîne sécurisée en chaîne standard chiffrée. Les longueurs de clé valides sont 16, 24 et 32 octets.
       
    -asPlainText <SwitchParameter>
        Spécifie une chaîne de texte brut à convertir en chaîne sécurisée. Les applets de commande SecureString permettent de protéger du texte confidentiel.  Le texte est chiffré pour en préserver la confidentialité et est supprimé de la mémoire de l'ordinateur après utilisation. Si vous utilisez ce paramètre pour fournir du texte brut en entrée, le système ne peut pas protéger cette entrée de la même manière.  Pour utiliser ce paramètre, vous devez également spécifier le paramètre Force.
       
    -force <SwitchParameter>
        Vérifie que vous comprenez les conséquences de l'utilisation du paramètre AsPlainText et vous invite à confirmer que vous souhaitez toujours l'utiliser.
       
    <CommonParameters>
        Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug,
        -ErrorAction, -ErrorVariable et -OutVariable. Pour plus d'informations,
        tapez « get-help about_commonparameters ».
   
    -------------------------- EXEMPLE 1 --------------------------
   
    C:\PS>$pwd = read-host -assecurestring
    $pwd
    $pwd = convertfrom-securestring $pwd
    $pwd
    $pwd = convertto-securestring $pwd
    $pwd
   
    Cette commande crée une chaîne sécurisée à l'aide de l'applet de commande Read-Host. Pour créer une chaîne sécurisée, vous devez taper des caractères et appuyer sur la touche ENTRÉE après la première commande. Elle affiche alors le résultat stocké dans la variable $pwd. Parce qu'il s'agit d'une chaîne sécurisée, le résultat est simplement le type System.Security.SecureString. Elle convertit ensuite le contenu de la variable $pwd en chaîne standard chiffrée en utilisant l'applet de commande ConvertFrom-SecureString. À la quatrième ligne, elle affiche cette chaîne standard chiffrée. À la cinquième ligne, elle utilise l'applet de commande ConvertTo-SecureString pour reconvertir la chaîne standard chiffrée stockée dans la variable $pwd en chaîne sécurisée. La dernière ligne de la commande essaie d'afficher la chaîne sécurisée. Le résultat est l'affichage du type System.Security.SecureString, ce qui confirme que le contenu de la variable $pwd a bien été reconverti en chaîne sécurisée.
   
   
   
   
    -------------------------- EXEMPLE 2 --------------------------
   
    C:\PS>$pwd = read-host -assecurestring
    $pwd
    $pwd = convertfrom-securestring $pwd -key (1..16)
    $pwd
    $pwd > enc_pwd.txt
    $pwd = convertto-securestring (get-content enc_pwd.txt) -key (1..16)
    $pwd
   
    Cette commande crée une chaîne sécurisée à l'aide de l'applet de commande Read-Host. Pour créer une chaîne sécurisée, vous devez taper des caractères et appuyer sur la touche ENTRÉE après la première commande. Elle affiche alors le résultat stocké dans la variable $pwd. Parce qu'il s'agit d'une chaîne sécurisée, le résultat est simplement le type System.Security.SecureString. Elle convertit alors le contenu de la variable $pwd en chaîne standard chiffrée avec la valeur de clé (1..16) en utilisant l'applet de commande ConvertFrom-SecureString. À la quatrième ligne, elle affiche cette chaîne standard chiffrée. À la cinquième ligne, elle utilise l'applet de commande ConvertTo-SecureString pour reconvertir la chaîne standard chiffrée stockée dans la variable $pwd en chaîne sécurisée. La dernière ligne de la commande essaie d'afficher la chaîne sécurisée. Le résultat est l'affichage du type System.Security.SecureString, ce qui confirme que le contenu de la variable $pwd a bien été reconverti en chaîne sécurisée.
   
   
   
   
    -------------------------- EXEMPLE 3 --------------------------
   
    C:\PS>$secure_string_pwd = convertto-securestring "P@ssW0rD!" -asplaintext -force
   
    Cette commande convertit la chaîne de texte brut "P@ssW0rD!" en chaîne sécurisée et stocke le résultat dans la variable $secure_string_pwd. Pour utiliser le paramètre AsPlainText, la commande doit également inclure le paramètre Force.
   
   
   
   
REMARQUES
    Pour plus d'informations, tapez : "get-help ConvertTo-SecureString -detailed".
    Pour obtenir des informations techniques, tapez : "get-help ConvertTo-SecureString -full".




Dernière mise à jour : ( 10-12-2006 )
 
© 2017 PowerShell-Scripting.com