IntuneTermsAndConditions¶
Parameters¶
| Parameter | Attribute | DataType | Description | Allowed Values |
|---|---|---|---|---|
| AcceptanceStatement | Write | String | Administrator-supplied explanation of the terms and conditions, typically describing what it means to accept the terms and conditions set out in the T&C policy. This is shown to the user on prompts to accept the T&C policy. | |
| BodyText | Write | String | Administrator-supplied body text of the terms and conditions, typically the terms themselves. This is shown to the user on prompts to accept the T&C policy. | |
| Description | Write | String | Administrator-supplied description of the T&C policy. | |
| DisplayName | Key | String | Administrator-supplied name for the T&C policy. | |
| RoleScopeTagIds | Write | StringArray[] | List of Scope Tags for this Entity instance. | |
| Title | Write | String | Administrator-supplied title of the terms and conditions. This is shown to the user on prompts to accept the T&C policy. | |
| Id | Write | String | The unique identifier for an entity. Read-only. | |
| Assignments | Write | MSFT_DeviceManagementConfigurationPolicyAssignments[] | Represents the assignment to the Intune policy. | |
| Ensure | Write | String | Present ensures the policy exists, absent ensures it is removed. | Present, Absent |
| Credential | Write | PSCredential | Credentials of the Admin | |
| ApplicationId | Write | String | Id of the Azure Active Directory application to authenticate with. | |
| TenantId | Write | String | Id of the Azure Active Directory tenant used for authentication. | |
| ApplicationSecret | Write | PSCredential | Secret of the Azure Active Directory tenant used for authentication. | |
| CertificateThumbprint | Write | String | Thumbprint of the Azure Active Directory application's authentication certificate to use for authentication. | |
| ManagedIdentity | Write | Boolean | Managed ID being used for authentication. | |
| AccessTokens | Write | StringArray[] | Access token used for authentication. |
Embedded Instances¶
MSFT_DeviceManagementConfigurationPolicyAssignments¶
Parameters¶
| Parameter | Attribute | DataType | Description | Allowed Values |
|---|---|---|---|---|
| dataType | Write | String | The type of the target assignment. | #microsoft.graph.cloudPcManagementGroupAssignmentTarget, #microsoft.graph.groupAssignmentTarget, #microsoft.graph.allLicensedUsersAssignmentTarget, #microsoft.graph.allDevicesAssignmentTarget, #microsoft.graph.exclusionGroupAssignmentTarget, #microsoft.graph.configurationManagerCollectionAssignmentTarget |
| deviceAndAppManagementAssignmentFilterType | Write | String | The type of filter of the target assignment i.e. Exclude or Include. Possible values are:none, include, exclude. | none, include, exclude |
| deviceAndAppManagementAssignmentFilterId | Write | String | The Id of the filter for the target assignment. | |
| deviceAndAppManagementAssignmentFilterDisplayName | Write | String | The display name of the filter for the target assignment. | |
| groupId | Write | String | The group Id that is the target of the assignment. | |
| groupDisplayName | Write | String | The group Display Name that is the target of the assignment. | |
| collectionId | Write | String | The collection Id that is the target of the assignment.(ConfigMgr) |
Description¶
Intune Terms And Conditions
Permissions¶
Microsoft Graph¶
To authenticate with the Microsoft Graph API, this resource requires the following permissions:
Delegated permissions¶
- Read
-
DeviceManagementServiceConfig.Read.All, Group.Read.All
-
Update
- DeviceManagementServiceConfig.ReadWrite.All, Group.Read.All
Application permissions¶
- Read
-
DeviceManagementServiceConfig.Read.All, Group.Read.All
-
Update
- DeviceManagementServiceConfig.ReadWrite.All, Group.Read.All
Examples¶
Example 1¶
This example is used to test new resources and showcase the usage of new resources being worked on. It is not meant to use as a production baseline.
Configuration Example
{
param
(
[Parameter()]
[System.String]
$ApplicationId,
[Parameter()]
[System.String]
$TenantId,
[Parameter()]
[System.String]
$CertificateThumbprint
)
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{
IntuneTermsAndConditions "IntuneTermsAndConditions-IntuneTermsAndConditions_1"
{
AcceptanceStatement = "Summary of Terms and Conditions";
ApplicationId = $ConfigurationData.NonNodeData.ApplicationId;
Assignments = @(
MSFT_DeviceManagementConfigurationPolicyAssignments{
dataType = "#microsoft.graph.groupAssignmentTarget"
deviceAndAppManagementAssignmentFilterType = "none"
groupDisplayName = "Include"
groupId = "56ae142c-f960-4436-a445-6b371fc8338b"
}
);
BodyText = "Some Terms and Conditions";
CertificateThumbprint = $ConfigurationData.NonNodeData.CertificateThumbprint;
Description = "";
DisplayName = "IntuneTermsAndConditions_1";
Ensure = "Present";
RoleScopeTagIds = @("0");
TenantId = $OrganizationName;
Title = "IntuneTermsAndConditions_1";
}
}
}
Example 2¶
This example is used to test new resources and showcase the usage of new resources being worked on. It is not meant to use as a production baseline.
Configuration Example
{
param
(
[Parameter()]
[System.String]
$ApplicationId,
[Parameter()]
[System.String]
$TenantId,
[Parameter()]
[System.String]
$CertificateThumbprint
)
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{
IntuneTermsAndConditions "IntuneTermsAndConditions-IntuneTermsAndConditions_1"
{
AcceptanceStatement = "Summary of Terms and Conditions";
ApplicationId = $ConfigurationData.NonNodeData.ApplicationId;
Assignments = @(
MSFT_DeviceManagementConfigurationPolicyAssignments{
dataType = "#microsoft.graph.groupAssignmentTarget"
deviceAndAppManagementAssignmentFilterType = "none"
groupDisplayName = "Include"
groupId = "56ae142c-f960-4436-a445-6b371fc8338b"
}
);
BodyText = "Some Terms and Conditions - With new updates"; # Updated property
CertificateThumbprint = $ConfigurationData.NonNodeData.CertificateThumbprint;
Description = "";
DisplayName = "IntuneTermsAndConditions_1";
Ensure = "Present";
RoleScopeTagIds = @("0");
TenantId = $OrganizationName;
Title = "IntuneTermsAndConditions_1";
}
}
}
Example 3¶
This example is used to test new resources and showcase the usage of new resources being worked on. It is not meant to use as a production baseline.
Configuration Example
{
param
(
[Parameter()]
[System.String]
$ApplicationId,
[Parameter()]
[System.String]
$TenantId,
[Parameter()]
[System.String]
$CertificateThumbprint
)
Import-DscResource -ModuleName Microsoft365DSC
node localhost
{
IntuneTermsAndConditions "IntuneTermsAndConditions-IntuneTermsAndConditions_1"
{
ApplicationId = $ConfigurationData.NonNodeData.ApplicationId;
CertificateThumbprint = $ConfigurationData.NonNodeData.CertificateThumbprint;
DisplayName = "IntuneTermsAndConditions_1";
Ensure = "Absent";
TenantId = $OrganizationName;
}
}
}