monkey365

0.95.1

core/api/EntraID/msgraph/utils/New-MonkeyEntraExternalCollaborationObject.ps1

                                # Monkey365 - the PowerShell Cloud Security Tool for Azure and Microsoft 365 (copyright 2022) by Juan Garrido

#

# Licensed under the Apache License, Version 2.0 (the "License");

# you may not use this file except in compliance with the License.

# You may obtain a copy of the License at

#

#     http://www.apache.org/licenses/LICENSE-2.0

#

# Unless required by applicable law or agreed to in writing, software

# distributed under the License is distributed on an "AS IS" BASIS,

# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

# See the License for the specific language governing permissions and

# limitations under the License.

Function New-MonkeyEntraCrossTenantAccessPolicyObject {

<#

        .SYNOPSIS

        Create a new Entra ID cross-tenant access policy object

        .DESCRIPTION

        Create a new Entra ID cross-tenant access policy object

        .INPUTS

        .OUTPUTS

        .EXAMPLE

        .NOTES

            Author        : Juan Garrido

            Twitter        : @tr1ana

            File Name    : New-MonkeyEntraCrossTenantAccessPolicyObject

            Version     : 1.0

        .LINK

            https://github.com/silverhack/monkey365

    #>

    [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseShouldProcessForStateChangingFunctions", "", Scope="Function")]

    [CmdletBinding()]

    Param ()

    Process{

        try{

            #Create ordered dictionary

            $crossTenantObj = [ordered]@{

                crossTenantAccessPolicy = $null;

                defaultCrossTenantAccessPolicy = $null;

                partnerCrossTenantAccessPolicy = $null;

            }

            #Create PsObject

            $_obj = New-Object -TypeName PsObject -Property $crossTenantObj

            #return object

            return $_obj

        }

        catch{

            $msg = @{

                MessageData = ($message.MonkeyObjectCreationFailed -f "Entra Id cross-tenant access policy object");

                callStack = (Get-PSCallStack | Select-Object -First 1);

                logLevel = 'error';

                InformationAction = $O365Object.InformationAction;

                Tags = @('EntraIdCrossTenantPolicyObjectError');

            }

            Write-Error @msg

            $msg.MessageData = $_

            $msg.LogLevel = "Verbose"

            $msg.Tags+= "EntraIdCrossTenantPolicyObjectError"

            [void]$msg.Add('verbose',$O365Object.verbose)

            Write-Verbose @msg

        }

    }

}