WindowsFeature
Synopsis
Installez ou désinstallez un rôle ou une fonctionnalité Windows.
Syntaxe
WindowsFeature [String] #ResourceName
{
Name = [string]
[Credential = [PSCredential]]
[DependsOn = [string[]]]
[Ensure = [string]{ Absent | Present }]
[IncludeAllSubFeature = [bool]]
[LogPath = [string]]
[PsDscRunAsCredential = [PSCredential]]
}
Description
La WindowsFeature
ressource vous permet de vérifier si un rôle ou une fonctionnalité Windows est installé sur un Serveur Windows. Pour gérer un ordinateur client, utilisez la ressource WindowsOptionalFeature.
Configuration requise
- L’ordinateur cible doit exécuter Windows Server 2008 ou version ultérieure.
- L’ordinateur cible doit avoir accès au module PowerShell DISM .
- L’ordinateur cible doit avoir accès au module PowerShell ServerManager .
Propriétés
Propriétés de la clé
Nom
Spécifiez le nom du rôle ou de la fonctionnalité en tant que chaîne.
Cette valeur de cette propriété doit être identique à la propriété Name du rôle ou de la fonctionnalité, et non à la propriété DisplayName . Pour répertorier les rôles et fonctionnalités disponibles pour un ordinateur, utilisez l’applet de Get-WindowsFeature
commande.
Type: System.String
Propriétés facultatives
Informations d'identification
Spécifiez les informations d’identification d’un compte pour ajouter ou supprimer le rôle ou la fonctionnalité en tant que.
Type: System.Management.Automation.PSCredential
Default Value: None
Ensure
Spécifiez si le rôle ou la fonctionnalité doivent être installés. Définissez cette propriété pour Present
installer le rôle ou la fonctionnalité s’il n’est pas installé. Définissez cette propriété pour Absent
désinstaller le rôle ou la fonctionnalité s’il est installé.
La valeur par défaut est Present
.
Type: System.String
Accepted Values:
- Absent
- Present
Default Value: Present
IncludeAllSubFeature
Spécifiez s’il faut installer chaque sous-objet de la fonctionnalité ou du rôle. Définissez cette propriété pour $true
installer toutes les sous-features manquantes. Définissez cette propriété pour $false
ignorer les sous-features. Quel que soit le paramètre de cette propriété, la ressource supprime toutes les sous-features si Ensure est défini sur Absent
.
La valeur par défaut est $false
.
Type: System.Boolean
Behavior: Write
Default Value: false
LogPath
Spécifiez le chemin d’accès à un fichier pour enregistrer l’installation ou la désinstallation de la fonctionnalité ou du rôle.
Type: System.String
Default Value: None
Propriétés en lecture seule
DisplayName
Nom complet du rôle ou de la fonctionnalité récupérés.
Type: System.String
Exemples
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour