functions/SPClientContentType/New-SPClientContentType.ps1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
#Requires -Version 3.0

<#
  New-SPClientContentType.ps1
 
  Copyright (c) 2017 karamem0
 
  This software is released under the MIT License.
  https://github.com/karamem0/SPClient/blob/master/LICENSE
#>


function New-SPClientContentType {

<#
.SYNOPSIS
  Creates a new content type.
.DESCRIPTION
  The New-SPClientContentType function adds a new content type to the site.
.PARAMETER ClientContext
  Indicates the client context. If not specified, uses default context.
.PARAMETER ParentObject
  Indicates the site or list which a content type to be created.
.PARAMETER Name
  Indicates the internal name.
.PARAMETER Description
  Indicates the description.
.PARAMETER Group
  Indicates the group name.
.PARAMETER ParentContentType
  Indicates the parent content type.
.PARAMETER Retrieval
  Indicates the data retrieval expression.
.EXAMPLE
  New-SPClientContentType $web -Name "Custom Content Type"
.INPUTS
  None or SPClient.SPClientContentTypeParentPipeBind
.OUTPUTS
  Microsoft.SharePoint.Client.ContentType
.LINK
  https://github.com/karamem0/SPClient/blob/master/doc/New-SPClientContentType.md
#>


    [CmdletBinding()]
    param (
        [Parameter(Mandatory = $false)]
        [Microsoft.SharePoint.Client.ClientContext]
        $ClientContext = $SPClient.ClientContext,
        [Parameter(Mandatory = $true, Position = 0, ValueFromPipeline = $true)]
        [SPClient.SPClientContentTypeParentPipeBind]
        $ParentObject,
        [Parameter(Mandatory = $true)]
        [string]
        $Name,
        [Parameter(Mandatory = $false)]
        [string]
        $Description,
        [Parameter(Mandatory = $false)]
        [string]
        $Group,
        [Parameter(Mandatory = $false)]
        [Microsoft.SharePoint.Client.ContentType]
        $ParentContentType,
        [Parameter(Mandatory = $false)]
        [string]
        $Retrieval
    )

    process {
        if ($ClientContext -eq $null) {
            throw "Cannot bind argument to parameter 'ClientContext' because it is null."
        }
        $Creation = New-Object Microsoft.SharePoint.Client.ContentTypeCreationInformation
        $Creation.Name = $Name
        if ($PSBoundParameters.ContainsKey('Group')) {
            $Creation.Group = $Group
        }
        if ($PSBoundParameters.ContainsKey('ParentContentType')) {
            if (-not $ParentContentType.IsPropertyAvailable('Id')) {
                Invoke-ClientContextLoad `
                    -ClientContext $ClientContext `
                    -ClientObject $ParentContentType `
                    -Retrieval 'Id'
            }
            $Creation.ParentContentType = $ParentContentType
        }
        $ClientObject = $ParentObject.ClientObject.ContentTypes.Add($Creation)
        $ClientObject.Description = $Description
        $ClientObject.Update($false)
        Invoke-ClientContextLoad `
            -ClientContext $ClientContext `
            -ClientObject $ClientObject `
            -Retrieval $Retrieval
        Write-Output $ClientObject
    }

}