WindowsFeature

  • Article

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