OSDCloud Workspace
New-OSDCloudWorkspace
New-OSDCloud.workspace has been renamed to New-OSDCloudWorkspace (without the period in the name). The old name is now an Alias, but that will be removed on April 1, 2022
This function requires elevated Admin Rights
Before getting too deep on how to create an OSDCloud Workspace, let me first explain what an OSDCloud Workspace is. In a nutshell, an OSDCloud Workspace is a copy of the OSDCloud Template that you can customize with Configuration Files, Wallpaper, Drivers, and Startup Configuration. Since it is a copy of your OSDCloud Template, this allows you to create multiple OSDCloud Workspaces that are customized with different configurations. The best example I can give as to why you might need separate OSDCloud Workspaces is to keep one for Development and the second for Production

Get-OSDCloudWorkspace

OSD/Get-OSDCloudWorkspace.md at master · OSDeploy/OSD
GitHub
It's a good idea to remember how to know what your current OSDCloud Workspace is. You can find out with the Get-OSDCloudWorkspace function
On a system that has never created an OSDCloud Workspace, you will receive the following Warning and nothing will be returned
1
PS C:\> Get-OSDCloudWorkspace
2
WARNING: 2022-02-22-223047 Unable to locate C:\ProgramData\OSDCloud\workspace.json
Copied!
Here is an example of how to test if you have an OSDCloud Workspace
1
PS C:\> if (Get-OSDCloudWorkspace) {$true} else {$false}
2
WARNING: 2022-02-22-223256 Unable to locate C:\ProgramData\OSDCloud\workspace.json
3
False
Copied!
Ideally, you should get a path returned if you have an OSDCloud Workspace
1
PS C:\> Get-OSDCloudWorkspace
2
C:\OSDCloud
Copied!
The current OSDCloud Workspace is stored in the OSDCloud Template at C:\ProgramData\OSDCloud\workspace.json

[Admin] Set-OSDCloudWorkspace

OSD/Set-OSDCloudWorkspace.md at master · OSDeploy/OSD
GitHub
The OSDCloud Workspace can also be set. This is typically handled automatically when you create a new OSDCloud Workspace, but you can also set this with the Set-OSDCloudWorkspace function. Here are some examples
1
[ADMIN]: PS C:\> Get-OSDCloudWorkspace
2
C:\OSDCloud
3
4
[ADMIN]: PS C:\> Set-OSDCloudWorkspace C:\OSDCloudDev
5
C:\OSDCloudDev
6
7
[ADMIN]: PS C:\> Get-OSDCloudWorkspace
8
C:\OSDCloudDev
9
10
[ADMIN]: PS C:\> Set-OSDCloudWorkspace -WorkspacePath C:\OSDCloudProd
11
C:\OSDCloudProd
12
13
[ADMIN]: PS C:\> Get-OSDCloudWorkspace
14
C:\OSDCloudProd
Copied!

[Admin] New-OSDCloudWorkspace

OSD/New-OSDCloudWorkspace.md at master · OSDeploy/OSD
GitHub

[Default] fromTemplate

Now that you understand how to Get and Set an OSDCloud Workspace, here are some examples on how to create a new OSDCloud Workspace
1
[ADMIN]: PS C:\> New-OSDCloudWorkspace
2
2022-02-23-004127 New-Item C:\OSDCloud
3
2022-02-23-004128 New-OSDCloudWorkspace created at C:\OSDCloud
4
5
6
[ADMIN]: PS C:\> New-OSDCloudWorkspace C:\OSDCloudDev
7
2022-02-23-004148 New-Item C:\OSDCloudDev
8
2022-02-23-004149 New-OSDCloudWorkspace created at C:\OSDCloudDev
9
10
11
[ADMIN]: PS C:\> New-OSDCloudWorkspace -WorkspacePath C:\OSDCloudProd
12
2022-02-23-004214 New-Item C:\OSDCloudProd
13
2022-02-23-004215 New-OSDCloudWorkspace created at C:\OSDCloudProd
14
15
16
[ADMIN]: PS C:\> Get-OSDCloudWorkspace
17
C:\OSDCloudProd
Copied!

fromIsoFile

If you have an existing OSDCloud ISO, you can use this to create a new OSDCloud Workspace and the -fromIsoFile parameter. Here is an example of how this works

fromIsoUrl

You may be able to specify the URL of an ISO file for the -fromIsoUrl parameter. This will download the ISO, mount the ISO, create the OSDCloud Workspace, then dismount the ISO

fromUsbDrive

If you have an OSDCloud USB, you can use the -fromUsbDrive switch parameter to create the OSDCloud Workspace from the USB content

OSDCloud Workspace Contents

This is what an OSDCloud Workspace looks like when created from an OSDCloud Template

Sponsor

Home
Recast Software
OSDeploy is sponsored by Recast Software