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-->

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.

Examples

EXAMPLE 1

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.

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

Parameters

-ServerName

This string specifies the network identity of the computer on which the share is being published.

Type: String
Position: Named
Default value: None
Required: True
Accept pipeline input: False
Accept wildcard characters: 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.

Type: String
Position: Named
Default value: None
Required: True
Accept pipeline input: False
Accept wildcard characters: 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”.

Type: String
Position: Named
Default value: None
Required: True
Accept pipeline input: False
Accept wildcard characters: 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”.

Type: String[]
Position: Named
Default value: None
Required: True
Accept pipeline input: False
Accept wildcard characters: 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”.

Type: String[]
Position: Named
Default value: None
Required: True
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

None

You can’t pipe objects to this cmdlet.

Outputs

None

By default, this cmdlet returns no output.

New-UserProfileShare