« PowerShell/Bonne pratique » : différence entre les versions

Aller à la navigation Aller à la recherche
Ligne 21 : Ligne 21 :
<#
<#
.SYNOPSIS
.SYNOPSIS
Texte du résumé de la fonction
    Texte du résumé de la fonction


.DESCRIPTION
.DESCRIPTION
     Description  
     Description


.PARAMETER Source
.PARAMETER Source
Ligne 41 : Ligne 41 :


.OUTPUTS
.OUTPUTS
 
.NOTES
.NOTES
NAME: MaFonction.ps1
    NAME: MaFonction.ps1
AUTHOR: fylip22
    AUTHOR: fylip22
EMAIL: fylip22@phpage.fr
    EMAIL: fylip22@phpage.fr
WWW: kono.phpage.fr
    WWW: kono.phpage.fr
 
VERSION HISTORY:


1.0 2023.11.15
    VERSION HISTORY:
    Initial Version
        1.0   2023.11.15
        Initial Version


     TODO
     TODO
    * gérer l'existence du dossier de destination ; le créer si nécessaire
        * gérer l'existence du dossier de destination ; le créer si nécessaire
#>
#>
</source>
</source>

Version du 4 décembre 2023 à 22:12

Quelques bonnes pratiques pour PowerShell.

Entête

Script simple

<#
Description : création d'un fichier HTML de la liste des 10 premiers services, avec actualisation de la page toutes les 3 secondes
Usage       : exercice en PowerShell
Auteur      : fylip22
Version     : 1.0
Révisions   :
	- 1.0 (01/11/2023) : création du script
#>

Fonction

<#
.SYNOPSIS
    Texte du résumé de la fonction

.DESCRIPTION
    Description

.PARAMETER Source
    Description du paramètre "Source"

.PARAMETER Destination
    Description du paramètre "Destination"

.EXAMPLE
    .\MaFonction.ps1 -Source "\\PHP001\Source\" -Dest "C:\temp"

.EXAMPLE
    .\MaFonction.ps1 -Source "\\PHP001\Support\" -Dest "C:\Sauvegarde\"

.INPUTS

.OUTPUTS

.NOTES
    NAME: MaFonction.ps1
    AUTHOR: fylip22
    EMAIL: fylip22@phpage.fr
    WWW: kono.phpage.fr

    VERSION HISTORY:
        1.0    2023.11.15
        Initial Version

    TODO
        * gérer l'existence du dossier de destination ; le créer si nécessaire
#>

Variable de paramètres

Pour une clarté dans la lecture d'un script, utiliser une variable de type tableau avec les différentes valeurs, puis utiliser cette variable avec la commande souhaitée.

Création d'un utilisateur sur l'AD : New-ADUser @ParametreListe

$ParametreListe = @{
   SAMAccountName    = "Nomp";
   Path              = "OU=SI, DC=php, DC=local";
   AccountPassword   = (ConvertTo-SecureString "MonMotDePasse" -AsPlainText -Force);
   Enable            = $true;
   UserPrincipalName = "prenom.nom@php.local";
   Name              = "Nom Prénom";
   EmailAddress      = "prenom.nom@societe.fr";
   DisplayName       = "Nom Prénom";
   GivenName         = "Prénom";
   Surname           = "Nom";
   Office            = "B052";
   EmployeeID        = "123";
   Title             = "Chef de projet";
   Company           = "Société";
   Division          = "Ma division";
   Department        = "Mon service";
   MobilePhone       = "+33 6 78 90 12 34";
   StreetAddress     = "1 Nom de la rue";
   City              = "Ma Ville";
   State             = "Ma Région";
   PostalCode        = "12300";
   Country           = "Mon Pays";
   OfficePhone       = "+33 1 23 45 67 89";
   }
New-ADUser @ParametreListe

Voir aussi

  •