Export-WdsInstallImage
Export-WdsInstallImage
Exports an existing install image from an image store.
Syntaxe
Parameter Set: InstallImageName
Export-WdsInstallImage -Destination <String> -ImageName <String> [-Append] [-AsJob] [-CimSession <CimSession[]> ] [-FileName <String> ] [-Force] [-ImageGroup <String> ] [-NewDescription <String> ] [-NewImageName <String> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]
Description détaillée
The Export-WdsInstallImage cmdlet exports an existing install image from an image store to a file. If an image file already exists in that location, you may overwrite it, append the new image to a file, or leave it in place. Specify the install image with the image name and image group name. You must specify the file name if the image name and image group name do not uniquely identify the install image.
Paramètres
-Append
Indicates that the cmdlet appends an image to an existing image file. The cmdlet creates a new file with the image if there is no existing image file.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-AsJob
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-CimSession<CimSession[]>
Exécute l’applet de commande dans une session à distance ou sur un ordinateur distant. Entrez un nom d’ordinateur ou un objet de session, comme la sortie d’une applet de commande New-CimSession ou Get-CimSession. La valeur par défaut est la session active sur l’ordinateur local.
Alias |
Session |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Destination<String>
Specifies a fully-qualified path that is accessible to the Windows Deployment Service server.
Alias |
none |
Obligatoire ? |
true |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-FileName<String>
Specifies a file name. This is the file name of the install image. Specifies the file name of the install image. Use this parameter to specify the file name for the install image if the install image name does not uniquely identify the image.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-Force
Force la commande à s’exécuter sans demander confirmation à l’utilisateur.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-ImageGroup<String>
Specifies the name of an image group. This image group contains the image to export. If you do not specify an image group, and only one image group exists on the server, the cmdlet uses that image group by default. If more than one image group exists on the server, you must specify the image group
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-ImageName<String>
Specifies the name of an image. This is the name of the image to export.
Alias |
none |
Obligatoire ? |
true |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-NewDescription<String>
Specifies a new description for the install image to create in the export operation
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-NewImageName<String>
Specifies a new name for the image file to create in the export operation. If you do not specify a name, the cmdlet uses the display name of the source image.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-ThrottleLimit<Int32>
Spécifie le nombre maximal d’opérations simultanées qui peuvent être établies pour exécuter cette applet de commande. Si ce paramètre est omis ou si la valeur 0
est entrée, Windows PowerShell ® calcule une limitation optimale pour l’applet de commande en fonction du nombre d’applets de commande CIM qui s’exécutent sur l’ordinateur. La limitation s’applique seulement à l’applet de commande actuelle, et non pas à la session ni à l’ordinateur.
Alias |
none |
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d’informations, consultez about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Entrées
Le type d’entrée correspond au type des objets que vous pouvez transmettre à l’applet de commande.
Sorties
Le type de sortie est le type des objets émis par l’applet de commande.
- Microsoft.Management.Infrastructure.CimInstance#MSFT_WdsInstallImage
Exemples
Example 1: Export an image
This command exports an image and appends the image to an existing file, if it exists.
PS C:\> Export-WdsInstallImage -Append -Destination D:\images\exported.wim -ImageName "Windows Latest with LOB apps" -FileName install-3.wim -ImageGroup "Fabrikam Latest Images" -NewImageName "Fabrikam Latest"