IntuneWifiConfigurationPolicyWindows10

Parameters

Parameter Attribute DataType Description Allowed Values
Id Write String Id of the Intune policy.
DisplayName Key String Display name of the Intune policy.
Description Write String Description of the Intune policy.
ConnectAutomatically Write Boolean Connect automatically
ConnectToPreferredNetwork Write Boolean Connect to preferred network
ConnectWhenNetworkNameIsHidden Write Boolean Connect when network name is hidden
ForceFIPSCompliance Write Boolean Force FIPS compliance
MeteredConnectionLimit Write String Metered connection limit unrestricted, fixed, variable
NetworkName Write String Network name
PreSharedKey Write String Pre shared key
ProxyAutomaticConfigurationUrl Write String Proxy automatic configuration url
ProxyManualAddress Write String Proxy manual address
ProxyManualPort Write UInt32 Proxy manual port
ProxySetting Write String Proxy setting none, manual, automatic
Ssid Write String SSID
WifiSecurityType Write String Wi-Fi security open, wpaPersonal, wpaEnterprise, wep, wpa2Personal, wpa2Enterprise
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 Intune 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.

MSFT_DeviceManagementConfigurationPolicyAssignments

Parameters

Parameter Attribute DataType Description Allowed Values
dataType Write String The type of the target assignment. #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.
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

This resource configures an Intune Wifi Configuration Policy for Windows10 Device.

Permissions

Microsoft Graph

To authenticate with the Microsoft Graph API, this resource required the following permissions:

Delegated permissions

  • Read

    • Group.Read.All, DeviceManagementConfiguration.Read.All
  • Update

    • Group.Read.All, DeviceManagementConfiguration.ReadWrite.All

Application permissions

  • Read

    • Group.Read.All, DeviceManagementConfiguration.Read.All
  • Update

    • Group.Read.All, DeviceManagementConfiguration.ReadWrite.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
    {
        IntuneWifiConfigurationPolicyWindows10 'myWifiConfigWindows10Policy'
        {
            DisplayName                    = 'win10 wifi - revised'
            Assignments                    = @(
                MSFT_DeviceManagementConfigurationPolicyAssignments {
                    deviceAndAppManagementAssignmentFilterType = 'none'
                    dataType                                   = '#microsoft.graph.allDevicesAssignmentTarget'
                }
            )
            ConnectAutomatically           = $True
            ConnectToPreferredNetwork      = $True
            ConnectWhenNetworkNameIsHidden = $True
            ForceFIPSCompliance            = $True
            MeteredConnectionLimit         = 'fixed'
            NetworkName                    = 'MyWifi'
            ProxyAutomaticConfigurationUrl = 'https://proxy.contoso.com'
            ProxySetting                   = 'automatic'
            Ssid                           = 'ssid'
            WifiSecurityType               = 'wpa2Personal'
            Ensure                         = 'Present'
            ApplicationId         = $ApplicationId;
            TenantId              = $TenantId;
            CertificateThumbprint = $CertificateThumbprint;
        }
    }
}

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
    {
        IntuneWifiConfigurationPolicyWindows10 'myWifiConfigWindows10Policy'
        {
            DisplayName                    = 'win10 wifi - revised'
            Assignments                    = @(
                MSFT_DeviceManagementConfigurationPolicyAssignments {
                    deviceAndAppManagementAssignmentFilterType = 'none'
                    dataType                                   = '#microsoft.graph.allDevicesAssignmentTarget'
                }
            )
            ConnectAutomatically           = $True
            ConnectToPreferredNetwork      = $False # Updated Property
            ConnectWhenNetworkNameIsHidden = $True
            ForceFIPSCompliance            = $True
            MeteredConnectionLimit         = 'fixed'
            NetworkName                    = 'MyWifi'
            ProxyAutomaticConfigurationUrl = 'https://proxy.contoso.com'
            ProxySetting                   = 'automatic'
            Ssid                           = 'ssid'
            WifiSecurityType               = 'wpa2Personal'
            Ensure                         = 'Present'
            ApplicationId         = $ApplicationId;
            TenantId              = $TenantId;
            CertificateThumbprint = $CertificateThumbprint;
        }
    }
}

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
    {
        IntuneWifiConfigurationPolicyWindows10 'myWifiConfigWindows10Policy'
        {
            DisplayName                    = 'win10 wifi - revised'
            Ensure                         = 'Absent'
            ApplicationId         = $ApplicationId;
            TenantId              = $TenantId;
            CertificateThumbprint = $CertificateThumbprint;
        }
    }
}