Question [V3-Fonction]Proxy de Get-Help

Voici, pour PowerShell V3.0, une fonction permettant d'adresser l'aide US au lieu de pointer sur l'aide Fr.
Pour le moment le produit est localisé, mais pas les fichiers d'aides.
Le principe de ce proxy est de modifier la culture courante avant d'appeler le cmdlet Get-Help d'origine, celui-ci se base sur la fonction Using-Culture :
[code:1]
Function Get-Help {
[CmdletBinding(DefaultParameterSetName='AllUsersView', HelpUri='go.microsoft.com/fwlink/?LinkID=113316')]

param(
[Parameter(Position=0, ValueFromPipelineByPropertyName=$true)]
[string]
${Name},

[string]
${Path},

[ValidateSet('Alias','Cmdlet','Provider','General','FAQ','Glossary','HelpFile','ScriptCommand','Function','Filter','ExternalScript','All','DefaultHelp','Workflow')]
[string[]]
${Category},

[string[]]
${Component},

[string[]]
${Functionality},

[string[]]
${Role},

[Parameter(ParameterSetName='DetailedView', Mandatory=$true)]
[switch]
${Detailed},

[Parameter(ParameterSetName='AllUsersView')]
[switch]
${Full},

[Parameter(ParameterSetName='Examples', Mandatory=$true)]
[switch]
${Examples},

[Parameter(ParameterSetName='Parameters', Mandatory=$true)]
[string]
${Parameter},

[Parameter(ParameterSetName='Online', Mandatory=$true)]
[switch]
${Online},

[Parameter(ParameterSetName='ShowWindow', Mandatory=$true)]
[switch]
${ShowWindow},

[System.Globalization.CultureInfo]
${Culture} = \"en-US\" #Using-Culture
)

begin
{
try {
$outBuffer = $null
if ($PSBoundParameters.TryGetValue('OutBuffer', [ref]$outBuffer))
{
$PSBoundParameters = 1
}

$OldCulture = [Threading.Thread]::CurrentThread.CurrentCulture
$OldUICulture = [Threading.Thread]::CurrentThread.CurrentUICulture

$wrappedCmd = $ExecutionContext.InvokeCommand.GetCommand('Get-Help', [System.Management.Automation.CommandTypes]::Cmdlet)
if ($Culture)
{
[Void]$PSBoundParameters.Remove(\"Culture\"«»)
$scriptCmd = {& $wrappedCmd @PSBoundParameters }
}
[Threading.Thread]::CurrentThread.CurrentCulture = $culture
[Threading.Thread]::CurrentThread.CurrentUICulture = $culture
$scriptCmd = {& $wrappedCmd @PSBoundParameters }

$steppablePipeline = $scriptCmd.GetSteppablePipeline($myInvocation.CommandOrigin)
$steppablePipeline.Begin($PSCmdlet)
} catch {
throw
}

}

process
{
try {
$steppablePipeline.Process($_)
} catch {
throw
}
}

end
{
try {
$steppablePipeline.End()
} catch {
throw
}
finally {
[Threading.Thread]::CurrentThread.CurrentCulture = $OldCulture
[Threading.Thread]::CurrentThread.CurrentUICulture = $OldUICulture
}
}
<#

.ForwardHelpTargetName Get-Help
.ForwardHelpCategory Cmdlet

#>
}
[/code:1]
Un exemple :
[code:1]
#Pointe par défaut sur la version US
Get-help get-command -full
#Pointe sur la version indiquée
Get-help get-command -full -Culture fr-FR
[/code:1]
En cas de doublons de nom entre une fonction et un cmdlet, l'exécution des fonctions est prioritaire.

Une fonction à placer provisoirement dans votre profile utilisateur Powershell.

Une légére modification, avec la version 3.0 l'attribut Cmdletbinding déclare 3 propriètés supplémentaires , ce qui fait qu'une fois la version 3.0 installée :

MS propose la version 2.0 et 3.0 dans une même distribution,
Powershell partage le même profile pour la v3 et la v2 (Powershell.exe -Version 2.0),

en conséquence on doit soit gérer le code selon la version, plusieurs approches possibles, SI possible utiliser un code commun.

Afin que cette fonction soit compatible V2 et V3 il faut supprimer le paramètre HelpUri :
[code:1]
Function Get-Help {
[CmdletBinding(DefaultParameterSetName='AllUsersView')]

param(
[/code:1]
Cette fonction sera valide pour les deux versions. Et si vous avez le temps faîtes un copier/coller du code dans une console v3 puis dans une console v2.
Ce Powershel est un sacré parseur

Je sens qu'on ne pas s'ennuyer avec cette version ...<br><br>Message édité par: Laurent Dardenne, à: 30/09/12 12:40

Le paramètre -Online ne fonctionne pas avec le proxy, à priori la gestion MAML utilise la culture courante...
On obtient une erreur :
[code:1]
get-help get-content -online
#get-help : The online version of this Help topic cannot be displayed because the Internet address (URI) of the Help
#topic is not specified in the command code or in the help file for the command.
[/code:1]
Du coup on essaie avec le cmdlet d'origine et la culture US :
[code:1]
Using-Culture \&quot;en-US\&quot; { Microsoft.PowerShell.Core\get-help get-content -online}
#Microsoft.PowerShell.Core\get-help : The online version of this Help topic cannot be displayed because the Internet
#address (URI) of the Help topic is not specified in the command code or in the help file for the command.
[/code:1]
Même chose.

Utilisons la culture courante :
[code:1]
Microsoft.PowerShell.Core\get-help get-content -online
#http://technet.microsoft.com/fr-FR/library/dd347719.aspx
[/code:1]
Ce qui fonctionne, on pointe sur une doc en Français, mais pas sur le bonne version.

Une autre approche, extraction du lien de l'aide en ligne :
[code:1]
Get-Help Get-Content -full|Select-Object -Expand relatedLinks |
Foreach { $_[0].navigationLink[0].LinkText}
#renvoi go.microsoft.com/fwlink/?LinkID=204574
[/code:1]
qui elle pointe sur la version US à jour
[code:1]#http://technet.microsoft.com/library/hh847788.aspx[/code:1]


Si vous trouvez le lien pointant sur la liste de tout les cmdlet, je prends !
[edit]
C'est ici :
Windows PowerShell Core Modules <br><br>Message édité par: Laurent Dardenne, à: 2/10/12 10:10

Tu as utilisé une version 2012 US ?
Matthew BETTON écrit:

Je ne sais pas où ils en sont

La tête dans le guidon...

Quelques liens :
Windows PowerShell Support for Windows Server 2012

Windows PowerShell Core (3.0)

Windows PowerShell Core Modules

Windows PowerShell About Help Topics

Celle téléchargée, pour Seven en tout cas, ne semble pas à jour...

voir aussi :
technet.microsoft.com/en-us/library/bb978526.aspx

technet.microsoft.com/en-us/library/bb978526.aspx

Message édité par: Laurent Dardenne, à: 8/10/12 10:29