Citrix Virtual Apps and Desktops SDK

New-Userprofileshare

Creates a new Windows network share on a nominated computer, making it suitable for use as a profile store.

Syntax

New-UserProfileShare -ServerName <String> -ShareName <String> -PathOnServer <String> -UserGroups <String[]> -AdminGroups <String[]> [<CommonParameters>]
<!--NeedCopy-->

Detailed Description

Use this command as part of the procedure for creating a new profile store when configuring profile management for first use. A suitable folder is assumed to already exist locally on the nominated computer. If no such folder exists, then you will need to create it on the machine before running this command. This command automates the process of transforming that folder into a published network share with suitable access control for profile management.

When using this command to publish a share, you will need to supply information about the security groups of users who will be storing their profiles on the share. You can also optionally specify security groups who will be given an administrative level of access, should your organisation require this.

Parameters

Name Description Required? Pipeline Input Default Value
ServerName This string specifies the network identity of the computer on which the share is being published. true false  
ShareName This specifies the desired name of the share itself. It is recommended (although not required) that share names end with the “$” character, so that they are excluded from casual enumerations of available shares. true false  
PathOnServer This string specifies the absolute path of the local directory on the server computer, which will become the shared folder. This path must make sense from the point of view of the server, so it must not be a UNC path. A path might, for example, be of the form “C:\UserProfiles\FinanceDepartment”. true false  
UserGroups This array of strings specifies the names of security groups whose members will be creating their profiles in the store. This array must contain at least one entry. Each string must be specified as a Windows object identifier, such as “FABRIKAM\Domain Users”. true false  
AdminGroups This array of strings specifies the names of security groups that should be given an administrative level of access to the profile share. If no such access is required, the array can be supplied as empty. Each string must be specified as a Windows object identifier, such as “FABRIKAM\Administrators”. true false  

Input Type

None

Return Values

None

Examples

Example 1

C:PS> New-UserProfileShare -ServerName ProfileServer -ShareName Profiles$ -PathOnServer C:\ProfileStore -UserGroups @("FABRIKAM\Domain Users") -AdminGroups @("FABRIKAM\Administrators")
<!--NeedCopy-->

Description

This command creates a new network share called “Profiles$” on the machine called “ProfileServer”. It does this by sharing the folder “C:\ProfileStore”, which will already be resident on ProfileServer. The store can be used by all domain users in the FABRIKAM domains. The store (including all of the user profiles that are subsequently stored within it) will also be accessible to the domain administrators. Following successful execution of this command, the network share whose UNC name is “\\ProfileServer\Profiles$” will exist. This makes it possible, for instance, to establish “\\ProfileServer\Profiles$\%USERNAME%.%USERDOMAIN” as a valid store path when configuring profile management.

New-Userprofileshare