Update-TypeData

Module:: Microsoft.PowerShell.Utility Module

Met à jour les données de type étendu dans la session.

Syntaxe

FileSet (Par défaut)

Update-TypeData
    [[-AppendPath] <String[]>]
    [-PrependPath <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DynamicTypeSet

Update-TypeData
    -TypeName <String>
    [-MemberType <PSMemberTypes>]
    [-MemberName <String>]
    [-Value <Object>]
    [-SecondValue <Object>]
    [-TypeConverter <Type>]
    [-TypeAdapter <Type>]
    [-SerializationMethod <String>]
    [-TargetTypeForDeserialization <Type>]
    [-SerializationDepth <Int32>]
    [-DefaultDisplayProperty <String>]
    [-InheritPropertySerializationSet <Nullable`1>]
    [-StringSerializationSource <String>]
    [-DefaultDisplayPropertySet <String[]>]
    [-DefaultKeyPropertySet <String[]>]
    [-PropertySerializationSet <String[]>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

TypeDataSet

Update-TypeData
    [-TypeData] <TypeData[]>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

L’applet Update-TypeData de commande met à jour les données de type étendues dans la session en rechargeant les Types.ps1xml fichiers en mémoire et en ajoutant de nouvelles données de type étendu.

Par défaut, PowerShell charge les données de type étendues en fonction des besoins. Sans paramètres, Update-TypeData recharge tous les Types.ps1xml fichiers qu’il a chargés dans la session, y compris les fichiers de type que vous avez ajoutés. Vous pouvez utiliser les paramètres de l’ajout de Update-TypeData nouveaux fichiers de type et ajouter et remplacer des données de type étendues.

L’applet Update-TypeData de commande peut être utilisée pour précharger toutes les données de type. Cette fonctionnalité est particulièrement utile lorsque vous développez des types et que vous souhaitez charger ces nouveaux types à des fins de test.

À compter de Windows PowerShell 3.0, vous pouvez l’utiliser Update-TypeData pour ajouter et remplacer des données de type étendu dans la session sans utiliser de Types.ps1xml fichier. Les données de type ajoutées dynamiquement, c’est-à-dire sans fichier, sont ajoutées uniquement à la session active. Pour ajouter les données de type à toutes les sessions, ajoutez une Update-TypeData commande à votre profil PowerShell. Pour plus d’informations, consultez about_Profiles.

En outre, à partir de Windows PowerShell 3.0, vous pouvez utiliser l’applet Get-TypeData de commande pour obtenir les types étendus dans la session active et l’applet Remove-TypeData de commande pour supprimer les types étendus de la session active.

Les exceptions qui se produisent dans les propriétés ou à partir de l’ajout de propriétés à une Update-TypeData commande ne signalent pas d’erreurs. Cela permet de supprimer les exceptions qui se produisent dans de nombreux types courants lors de la mise en forme et de la sortie. Si vous obtenez des propriétés .NET, vous pouvez contourner la suppression des exceptions à l’aide de la syntaxe de méthode à la place, comme illustré dans l’exemple suivant :

"hello".get_Length()

Notez que la syntaxe de méthode ne peut être utilisée qu’avec les propriétés .NET. Les propriétés ajoutées en exécutant l’applet de commande Update-TypeData ne peuvent pas utiliser la syntaxe de méthode.

Pour plus d’informations sur les Types.ps1xml fichiers dans PowerShell, consultez about_Types.ps1xml.

Exemples

Exemple 1 : Mettre à jour les types étendus

Update-TypeData

Cette commande met à jour la configuration de type étendu à partir des Types.ps1xml fichiers qui ont déjà été utilisés dans la session.

Exemple 2 : Mettre à jour plusieurs fois les types

Cet exemple montre comment mettre à jour les types dans un fichier de type plusieurs fois dans la même session.

La première commande met à jour la configuration de type étendu à partir des Types.ps1xml fichiers, en traitant d’abord les fichiers et TypesA.types.ps1xml les TypesB.types.ps1xml fichiers.

La deuxième commande montre comment mettre à jour la TypesA.types.ps1xml nouvelle fois, par exemple si vous avez ajouté ou modifié un type dans le fichier. Vous pouvez répéter la commande précédente pour le TypesA.types.ps1xml fichier ou exécuter une Update-TypeData commande sans paramètres, car TypesA.types.ps1xml elle figure déjà dans la liste de fichiers de type de la session active.

Update-TypeData -PrependPath TypesA.types.ps1xml, TypesB.types.ps1xml
Update-TypeData -PrependPath TypesA.types.ps1xml

Exemple 3 : Ajouter une propriété de script à des objets DateTime

Cet exemple utilise Update-TypeData pour ajouter la propriété de script Quarter aux objets System.DateTime dans la session active, telles que celles retournées par l’applet Get-Date de commande.

$typeDataParams = @{
    TypeName   = 'System.DateTime'
    MemberType = 'ScriptProperty'
    MemberName = 'Quarter'
    Value      = {
        switch ($this.Month) {
            { $_ -in @(1, 2, 3) } { return 'Q1' }
            { $_ -in @(4, 5, 6) } { return 'Q2' }
            { $_ -in @(7, 8, 9) } { return 'Q3' }
            default               { return 'Q4' }
        }
    }
}
Update-TypeData @typeDataParams

(Get-Date).Quarter

Q1

La Update-TypeData commande utilise le paramètre TypeName pour spécifier le type System.DateTime , le paramètre MemberName pour spécifier un nom pour la nouvelle propriété, la propriété MemberType pour spécifier le type ScriptProperty et le paramètre Value pour spécifier le script qui détermine le trimestre annuel.

La valeur de la propriété Value est un script qui calcule le trimestre annuel actuel. Le bloc de script utilise la $this variable automatique pour représenter l’instance actuelle de l’objet et l’opérateur In pour déterminer si la valeur du mois apparaît dans chaque tableau entier. Pour plus d'informations sur l'opérateur -in, consultez à propos des opérateurs de comparaison.

La deuxième commande obtient la nouvelle propriété Quarter de la date actuelle.

Exemple 4 : Mettre à jour un type qui s’affiche dans des listes par défaut

Cet exemple montre comment définir les propriétés d’un type qui s’affiche dans les listes par défaut, c’est-à-dire quand aucune propriété n’est spécifiée. Étant donné que les données de type ne sont pas spécifiées dans un Types.ps1xml fichier, elles sont effectives uniquement dans la session active.

Get-Date | Format-List

Update-TypeData -TypeName "System.DateTime" -DefaultDisplayPropertySet @(
    'DateTime'
    'DayOfYear'
    'Quarter'
)

Get-Date | Format-List

DisplayHint : DateTime
Date        : 8/7/2024 12:00:00 AM
Day         : 7
DayOfWeek   : Wednesday
DayOfYear   : 220
Hour        : 10
Kind        : Local
Millisecond : 568
Microsecond : 308
Nanosecond  : 600
Minute      : 34
Month       : 8
Second      : 43
Ticks       : 638586236835683086
TimeOfDay   : 10:34:43.5683086
Year        : 2024
DateTime    : Wednesday, August 7, 2024 10:34:43 AM
Quarter     : Q3


DateTime  : Wednesday, August 7, 2024 10:34:43 AM
DayOfYear : 220
Quarter   : Q3

La première commande affiche l’affichage liste de la Get-Date commande, qui génère un objet System.DateTime qui représente la date actuelle. La commande utilise un opérateur de pipeline (|) pour envoyer l’objet DateTime à l’applet Format-List de commande. Étant donné que la Format-List commande ne spécifie pas les propriétés à afficher dans la liste, PowerShell affiche chaque propriété publique non masquée pour l’objet.

La deuxième commande utilise l’applet Update-TypeData de commande pour définir les propriétés de liste par défaut pour le type System.DateTime . La commande utilise le paramètre TypeName pour spécifier le type et le paramètre DefaultDisplayPropertySet pour spécifier les propriétés par défaut d’une liste. Les propriétés sélectionnées incluent la nouvelle propriété de script Quarter qui a été ajoutée dans un exemple précédent.

La dernière commande obtient la date actuelle et l’affiche à nouveau dans un format de liste. Elle affiche uniquement les propriétés définies dans la Update-TypeData commande, au lieu de la liste complète des propriétés.

Exemple 5 : Définir la propriété qu’un type affiche au format large

Cet exemple montre comment créer une propriété de script et l’utiliser comme propriété par défaut affichée lorsque le type est passé à l’applet Format-Wide de commande.

Get-Command *File* | Format-Wide

Set-AppPackageProvisionedDataFile                            Set-ProvisionedAppPackageDataFile
Set-ProvisionedAppXDataFile                                  Write-FileSystemCache
Write-FileSystemCache                                        Add-PoshGitToProfile
Block-FileShareAccess                                        Clear-FileStorageTier
Close-SmbOpenFile                                            Debug-FileShare
Disable-NetIPHttpsProfile                                    Enable-NetIPHttpsProfile
Get-FileIntegrity                                            Get-FileShare
Get-FileShareAccessControlEntry                              Get-FileStorageTier
Get-NetConnectionProfile                                     Get-NetFirewallHyperVProfile
Get-NetFirewallProfile                                       Get-SmbOpenFile
Get-StorageFileServer                                        Get-SupportedFileSystems
Grant-FileShareAccess                                        New-FileShare
New-NetFirewallHyperVProfile                                 New-ScriptFileInfo
New-ScriptFileInfo                                           New-StorageFileServer
Publish-BCFileContent                                        Remove-FileShare
Remove-NetFirewallHyperVProfile                              Remove-PoshGitFromProfile
Remove-StorageFileServer                                     Repair-FileIntegrity
Revoke-FileShareAccess                                       Set-FileIntegrity
Set-FileShare                                                Set-FileStorageTier
Set-NetConnectionProfile                                     Set-NetFirewallHyperVProfile
Set-NetFirewallProfile                                       Set-StorageBusProfile
Set-StorageFileServer                                        Test-ScriptFileInfo
Test-ScriptFileInfo                                          Unblock-FileShareAccess
Update-ScriptFileInfo                                        Update-ScriptFileInfo
Add-BitsFile                                                 Get-AppLockerFileInformation
Get-FileHash                                                 Get-PSScriptFileInfo
Import-PowerShellDataFile                                    New-FileCatalog
New-PSRoleCapabilityFile                                     New-PSScriptFileInfo
New-PSSessionConfigurationFile                               New-TemporaryFile
Out-File                                                     Set-AppXProvisionedDataFile
Test-FileCatalog                                             Test-PSScriptFileInfo
Test-PSSessionConfigurationFile                              Unblock-File
Update-PSScriptFileInfo                                      FileDialogBroker.exe
FileHistory.exe                                              forfiles.exe
openfiles.exe

$typeDataParams = @{
    TypeName               = 'System.Management.Automation.CommandInfo'
    DefaultDisplayProperty = 'FullyQualifiedName'
    MemberType             = 'ScriptProperty'
    MemberName             = 'FullyQualifiedName'
    Value                  = {
        [OutputType([string])]
        param()

        # For executables, return the path to the application.
        if ($this -is [System.Management.Automation.ApplicationInfo]) {
            return $this.Path
        }

        # For commands defined outside a module, return only the name.
        if ([string]::IsNullOrEmpty($this.ModuleName)) {
            return $this.Name
        }

        # Return the fully-qualified command name "<ModuleName>\<CommandName>"
        return '{0}\{1}' -f $this.ModuleName, $this.Name
    }
}
Update-TypeData @typeDataParams

Get-Command *File* | Format-Wide

Dism\Set-AppPackageProvisionedDataFile                       Dism\Set-ProvisionedAppPackageDataFile
Dism\Set-ProvisionedAppXDataFile                             Storage\Write-FileSystemCache
VMDirectStorage\Write-FileSystemCache                        posh-git\Add-PoshGitToProfile
Storage\Block-FileShareAccess                                Storage\Clear-FileStorageTier
SmbShare\Close-SmbOpenFile                                   Storage\Debug-FileShare
NetworkTransition\Disable-NetIPHttpsProfile                  NetworkTransition\Enable-NetIPHttpsProfile
Storage\Get-FileIntegrity                                    Storage\Get-FileShare
Storage\Get-FileShareAccessControlEntry                      Storage\Get-FileStorageTier
NetConnection\Get-NetConnectionProfile                       NetSecurity\Get-NetFirewallHyperVProfile
NetSecurity\Get-NetFirewallProfile                           SmbShare\Get-SmbOpenFile
Storage\Get-StorageFileServer                                Storage\Get-SupportedFileSystems
Storage\Grant-FileShareAccess                                Storage\New-FileShare
NetSecurity\New-NetFirewallHyperVProfile                     PowerShellGet\New-ScriptFileInfo
PowerShellGet\New-ScriptFileInfo                             Storage\New-StorageFileServer
BranchCache\Publish-BCFileContent                            Storage\Remove-FileShare
NetSecurity\Remove-NetFirewallHyperVProfile                  posh-git\Remove-PoshGitFromProfile
Storage\Remove-StorageFileServer                             Storage\Repair-FileIntegrity
Storage\Revoke-FileShareAccess                               Storage\Set-FileIntegrity
Storage\Set-FileShare                                        Storage\Set-FileStorageTier
NetConnection\Set-NetConnectionProfile                       NetSecurity\Set-NetFirewallHyperVProfile
NetSecurity\Set-NetFirewallProfile                           StorageBusCache\Set-StorageBusProfile
Storage\Set-StorageFileServer                                PowerShellGet\Test-ScriptFileInfo
PowerShellGet\Test-ScriptFileInfo                            Storage\Unblock-FileShareAccess
PowerShellGet\Update-ScriptFileInfo                          PowerShellGet\Update-ScriptFileInfo
BitsTransfer\Add-BitsFile                                    AppLocker\Get-AppLockerFileInformation
Microsoft.PowerShell.Utility\Get-FileHash                    Microsoft.PowerShell.PSResourceGet\Get-PSScriptFileInfo
Microsoft.PowerShell.Utility\Import-PowerShellDataFile       Microsoft.PowerShell.Security\New-FileCatalog
Microsoft.PowerShell.Core\New-PSRoleCapabilityFile           Microsoft.PowerShell.PSResourceGet\New-PSScriptFileInfo
Microsoft.PowerShell.Core\New-PSSessionConfigurationFile     Microsoft.PowerShell.Utility\New-TemporaryFile
Microsoft.PowerShell.Utility\Out-File                        Dism\Set-AppXProvisionedDataFile
Microsoft.PowerShell.Security\Test-FileCatalog               Microsoft.PowerShell.PSResourceGet\Test-PSScriptFileInfo
Microsoft.PowerShell.Core\Test-PSSessionConfigurationFile    Microsoft.PowerShell.Utility\Unblock-File
Microsoft.PowerShell.PSResourceGet\Update-PSScriptFileInfo   C:\WINDOWS\system32\FileDialogBroker.exe
C:\WINDOWS\system32\FileHistory.exe                          C:\WINDOWS\system32\forfiles.exe
C:\WINDOWS\system32\openfiles.exe

La première commande utilise l’applet Get-Command de commande pour renvoyer chaque commande avec un nom contenant le mot File. Il canalise la sortie vers l’applet Format-Wide de commande, qui affiche les noms des commandes dans les colonnes.

Ensuite, l’exemple utilise Update-TypeData pour définir à la fois defaultDisplayPropertyet une nouvelle propriété de script pour le type CommandInfo. Sortie pour Get-Command renvoyer des objets CommandInfo et des objets dérivés de ce type. La nouvelle propriété de script, FullyQualifiedName, retourne le chemin d’accès complet aux applications exécutables et le nom complet des applets de commande, qui préfixe le nom de l’applet de commande avec le module qui le définit. L’applet Update-TypeData de commande peut définir la nouvelle propriété de script et l’utiliser comme DefaultDisplayProperty dans la même commande.

Enfin, la sortie affiche les résultats de l’affichage Get-Command au format large après la mise à jour de type. Il affiche le nom complet des applets de commande et le chemin d’accès complet aux applications exécutables.

Exemple 6 : Mettre à jour les données de type pour un objet redirigé

$typeDataParams = @{
    MemberType = 'ScriptProperty'
    MemberName = 'SupportsUpdatableHelp'
    Value      = {
        [OutputType([bool])]
        param()

        return (-not [string]::IsNullOrEmpty($this.HelpInfoUri))
    }
}
Get-Module Microsoft.PowerShell.Utility | Update-TypeData @typeDataParams

Get-Module -ListAvailable -Name Microsoft.PowerShell.* |
    Format-Table Name, SupportsUpdatableHelp

Name                                      SupportsUpdatableHelp
----                                      ---------------------
Microsoft.PowerShell.Archive                               True
Microsoft.PowerShell.Diagnostics                           True
Microsoft.PowerShell.Host                                  True
Microsoft.PowerShell.Management                            True
Microsoft.PowerShell.PSResourceGet                         True
Microsoft.PowerShell.Security                              True
Microsoft.PowerShell.Utility                               True
Microsoft.PowerShell.Operation.Validation                  True
Microsoft.PowerShell.LocalAccounts                         True

Cet exemple montre que lorsque vous dirigez un objet vers Update-TypeData, Update-TypeData ajoute des données de type étendu pour le type d’objet.

Cette technique est plus rapide que l’utilisation de l’applet Get-Member de commande ou de la Get-Type méthode pour obtenir le type d’objet. Toutefois, si vous dirigez une collection d’objets vers Update-TypeData, il met à jour les données de type du premier type d’objet, puis retourne une erreur pour tous les autres objets de la collection, car le membre est déjà défini sur le type.

La première commande utilise l’applet Get-Module de commande pour obtenir le module Microsoft.PowerShell.Utility . La commande canalise l’objet module vers l’applet Update-TypeData de commande, qui met à jour les données de type pour le type System.Management.Automation.PSModuleInfo et les types dérivés de celui-ci, tels que le type ModuleInfoGrouping qui Get-Module retourne lorsque vous utilisez le paramètre ListAvailable dans la commande.

Les Update-TypeData commandes ajoutent la propriété de script SupportsUpdatableHelp à tous les modules importés. La valeur du paramètre Value est un script qui retourne $true si la propriété HelpInfoUri du module est remplie et $false sinon.

La deuxième commande canalise les objets de module de Get-Module l’applet Format-Table de commande, qui affiche les propriétés Name et SupportsUpdatableHelp des modules disponibles.

Paramètres

-AppendPath

Spécifie le chemin d’accès aux fichiers facultatifs .ps1xml . Les fichiers spécifiés sont chargés dans l’ordre dans lequel ils sont répertoriés après le chargement des fichiers intégrés. Vous pouvez également diriger une valeur AppendPath vers Update-TypeData.

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
Alias:	PSPath, Chemin

Jeux de paramètres

FileSet

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

-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
Alias:	cf

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

-DefaultDisplayProperty

Spécifie la propriété du type affiché par l’applet Format-Wide de commande lorsqu’aucune autre propriété n’est spécifiée.

Tapez le nom d’une propriété standard ou étendue du type. La valeur de ce paramètre peut être le nom d’un type ajouté dans la même commande.

Cette valeur n’est effective qu’en l’absence de vues larges définies pour le type d’un Format.ps1xml fichier.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

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

DynamicTypeSet

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

-DefaultDisplayPropertySet

Spécifie une ou plusieurs propriétés du type. Ces propriétés sont affichées par les Format-Listapplets de commande , Format-Tableet Format-Custom les applets de commande lorsqu’aucune autre propriété n’est spécifiée.

Tapez les noms des propriétés standard ou étendues du type. La valeur de ce paramètre peut être le nom des types ajoutés dans la même commande.

Cette valeur n’est effective qu’en l’absence de liste, de table ou de vues personnalisées, respectivement définies pour le type d’un Format.ps1xml fichier.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

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

DynamicTypeSet

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

-DefaultKeyPropertySet

Spécifie une ou plusieurs propriétés du type. Ces propriétés sont utilisées par les Group-Object applets de commande et Sort-Object quand aucune autre propriété n’est spécifiée.

Tapez les noms des propriétés standard ou étendues du type. La valeur de ce paramètre peut être le nom des types ajoutés dans la même commande.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

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

DynamicTypeSet

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

-Force

Indique que l’applet de commande utilise les données de type spécifiées, même si les données de type ont déjà été spécifiées pour ce type.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

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

DynamicTypeSet

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

TypeDataSet

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

-InheritPropertySerializationSet

Indique si l’ensemble de propriétés sérialisées est hérité. La valeur par défaut est $null. Les valeurs acceptables pour ce paramètre sont les suivantes :

$true. Le jeu de propriétés est hérité.
$false. Le jeu de propriétés n’est pas hérité.
$null. L’héritage n’est pas défini.

Ce paramètre est valide uniquement lorsque la valeur du paramètre SerializationMethod est SpecificProperties. Lorsque la valeur de ce paramètre est $false, le paramètre PropertySerializationSet est requis.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

Propriétés du paramètre

Type:	Nullable<T>[Boolean]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

DynamicTypeSet

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

-MemberName

Spécifie le nom d’une propriété ou d’une méthode.

Utilisez ce paramètre avec l'TypeName , MemberType, Valeur et paramètres SecondValue pour ajouter ou modifier une propriété ou une méthode d’un type.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

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

DynamicTypeSet

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

-MemberType

Spécifie le type du membre à ajouter ou modifier.

Utilisez ce paramètre avec l'TypeName , MemberType, Valeur et paramètres SecondValue pour ajouter ou modifier une propriété ou une méthode d’un type. Les valeurs acceptables pour ce paramètre sont les suivantes :

AliasProperty
CodeMethod
CodeProperty
Remarqueproperty
ScriptMethod
ScriptProperty

Pour plus d’informations sur ces valeurs, consultez énumération PSMemberTypes.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

Propriétés du paramètre

Type:	PSMemberTypes
Valeur par défaut:	None
Valeurs acceptées:	NoteProperty, AliasProperty, ScriptProperty, CodeProperty, ScriptMethod, CodeMethod
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

DynamicTypeSet

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

-PrependPath

Spécifie le chemin d’accès aux fichiers facultatifs .ps1xml . Les fichiers spécifiés sont chargés dans l’ordre dans lequel ils sont répertoriés avant le chargement des fichiers intégrés.

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

FileSet

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

-PropertySerializationSet

Spécifie les noms des propriétés sérialisées. Utilisez ce paramètre lorsque la valeur du paramètre SerializationMethod est SpecificProperties.

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

DynamicTypeSet

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

-SecondValue

Spécifie des valeurs supplémentaires pour AliasProperty, ScriptProperty, CodePropertyou membres de codeMethod.

Utilisez ce paramètre avec les paramètresTypeName , MemberType, Valueet Paramètres de SecondValue pour ajouter ou modifier une propriété ou une méthode d’un type.

Lorsque la valeur du paramètre MemberType est AliasProperty, la valeur du paramètre SecondValue doit être un type de données. PowerShell convertit (autrement dit, caste) la valeur de la propriété alias en type spécifié. Par exemple, si vous ajoutez une propriété d’alias qui fournit un autre nom pour une propriété de chaîne, vous pouvez également spécifier une SecondValue de System.Int32 pour convertir la valeur de chaîne alias en entier.

Lorsque la valeur du paramètre MemberType est ScriptProperty, vous pouvez utiliser le paramètre SecondValue pour spécifier un bloc de script supplémentaire. Le bloc de script dans la valeur du paramètre Value obtient la valeur d’une variable. Le bloc de script dans la valeur du paramètre SecondValue définit la valeur de la variable.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

Propriétés du paramètre

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

Jeux de paramètres

DynamicTypeSet

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

-SerializationDepth

Spécifie le nombre de niveaux d’objets de type sérialisés sous forme de chaînes. La valeur 1 par défaut sérialise l’objet et ses propriétés. Une valeur de 0 sérialise l’objet, mais pas ses propriétés. Une valeur de 2 sérialise l’objet, ses propriétés et tous les objets dans les valeurs de propriété.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

Propriétés du paramètre

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

Jeux de paramètres

DynamicTypeSet

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

-SerializationMethod

Spécifie une méthode de sérialisation pour le type. Une méthode de sérialisation détermine les propriétés du type sérialisées et la technique utilisée pour les sérialiser. Les valeurs acceptables pour ce paramètre sont les suivantes :

AllPublicProperties. Sérialisez toutes les propriétés publiques du type. Vous pouvez utiliser le paramètre SerializationDepth pour déterminer si les propriétés enfants sont sérialisées.
String. Sérialisez le type en tant que chaîne. Vous pouvez utiliser la StringSerializationSource pour spécifier une propriété du type à utiliser comme résultat de sérialisation. Sinon, le type est sérialisé à l’aide de la méthode ToString de l’objet.
SpecificProperties. Sérialisez uniquement les propriétés spécifiées de ce type. Utilisez le paramètre PropertySerializationSet pour spécifier les propriétés du type sérialisé. Vous pouvez également utiliser le paramètre InheritPropertySerializationSet pour déterminer si le jeu de propriétés est hérité et le paramètre SerializationDepth pour déterminer si les propriétés enfants sont sérialisées.

Dans PowerShell, les méthodes de sérialisation sont stockées dans des objets internes PSStandardMembers .

Ce paramètre a été introduit dans Windows PowerShell 3.0.

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

DynamicTypeSet

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

-StringSerializationSource

Spécifie le nom d’une propriété du type. La valeur de la propriété spécifiée est utilisée comme résultat de sérialisation. Ce paramètre est valide uniquement lorsque la valeur du paramètre SerializationMethod est String.

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

DynamicTypeSet

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

-TargetTypeForDeserialization

Spécifie le type vers lequel l’objet de ce type est converti lorsqu’il est désérialisé.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

Propriétés du paramètre

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

Jeux de paramètres

DynamicTypeSet

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

-TypeAdapter

Spécifie le type d’un adaptateur de type, tel que Microsoft.PowerShell.Cim.CimInstanceAdapter. Un adaptateur de type permet à PowerShell d’obtenir les membres d’un type.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

Propriétés du paramètre

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

Jeux de paramètres

DynamicTypeSet

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

-TypeConverter

Spécifie un convertisseur de type pour convertir des valeurs entre différents types. Si un convertisseur de type est défini pour un type, une instance du convertisseur de type est utilisée pour la conversion.

Entrez une valeur System.Type dérivée des classes System.ComponentModel.TypeConverter ou System.Management.Automation.PSTypeConverter.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

Propriétés du paramètre

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

Jeux de paramètres

DynamicTypeSet

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

-TypeData

Spécifie un tableau de données de type que cette applet de commande ajoute à la session. Entrez une variable qui contient un objet TypeData ou une commande qui obtient un objet TypeData , tel qu’une Get-TypeData commande. Vous pouvez également diriger un objet TypeData vers Update-TypeData.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

Propriétés du paramètre

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

Jeux de paramètres

TypeDataSet

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

-TypeName

Spécifie le nom du type à étendre.

Pour les types dans l’espace de noms système , entrez le nom court. Sinon, le nom de type complet est obligatoire. Les caractères génériques ne sont pas pris en charge.

Vous pouvez envoyer des noms de type à Update-TypeData via le pipeline. Lorsque vous dirigez un objet vers Update-TypeData, Update-TypeData obtient le nom de type de l’objet et les données de type vers le type d’objet.

Utilisez ce paramètre avec les paramètresMemberName , MemberType, Value et SecondValue pour ajouter ou modifier une propriété ou une méthode d’un type.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

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

DynamicTypeSet

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

-Value

Spécifie la valeur de la propriété ou de la méthode.

Si vous ajoutez un AliasProperty, ou CodePropertyScriptPropertyCodeMethod un membre, vous pouvez utiliser le paramètre SecondValue pour ajouter des informations supplémentaires.

Utilisez ce paramètre avec les paramètresMemberName , MemberType, Value et SecondValue pour ajouter ou modifier une propriété ou une méthode d’un type.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

Propriétés du paramètre

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

Jeux de paramètres

DynamicTypeSet

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

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

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
Alias:	Wi

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

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

Vous pouvez diriger une chaîne qui contient les valeurs des paramètres AppendPath, TypeName ou TypeData vers cette applet de commande.

Partager via

Update-TypeData

Syntaxe

FileSet (Par défaut)

DynamicTypeSet

TypeDataSet

Description

Exemples

Exemple 1 : Mettre à jour les types étendus

Exemple 2 : Mettre à jour plusieurs fois les types

Exemple 3 : Ajouter une propriété de script à des objets DateTime

Exemple 4 : Mettre à jour un type qui s’affiche dans des listes par défaut

Exemple 5 : Définir la propriété qu’un type affiche au format large

Exemple 6 : Mettre à jour les données de type pour un objet redirigé

Paramètres

-AppendPath

Propriétés du paramètre

Jeux de paramètres

-Confirm

Propriétés du paramètre

Jeux de paramètres

-DefaultDisplayProperty

Propriétés du paramètre

Jeux de paramètres

-DefaultDisplayPropertySet

Propriétés du paramètre

Jeux de paramètres

-DefaultKeyPropertySet

Propriétés du paramètre

Jeux de paramètres

-Force

Propriétés du paramètre

Jeux de paramètres

-InheritPropertySerializationSet

Propriétés du paramètre

Jeux de paramètres

-MemberName

Propriétés du paramètre

Jeux de paramètres

-MemberType

Propriétés du paramètre

Jeux de paramètres

-PrependPath

Propriétés du paramètre

Jeux de paramètres

-PropertySerializationSet

Propriétés du paramètre

Jeux de paramètres

-SecondValue

Propriétés du paramètre

Jeux de paramètres

-SerializationDepth

Propriétés du paramètre

Jeux de paramètres

-SerializationMethod

Propriétés du paramètre

Jeux de paramètres

-StringSerializationSource

Propriétés du paramètre

Jeux de paramètres

-TargetTypeForDeserialization

Propriétés du paramètre

Jeux de paramètres

-TypeAdapter

Propriétés du paramètre

Jeux de paramètres

-TypeConverter

Propriétés du paramètre

Jeux de paramètres

-TypeData

Propriétés du paramètre

Jeux de paramètres

-TypeName

Propriétés du paramètre

Jeux de paramètres

-Value

Propriétés du paramètre

Jeux de paramètres

-WhatIf

Propriétés du paramètre