Enable-SPOSiteRestrictedAppAccessControl

모듈:
Microsoft.Online.SharePoint.PowerShell Module

구성된 모드 및 목록을 사용하여 사이트에 대한 응용 프로그램 제한 적용을 켭니다.

구문

Default (기본값) 

Enable-SPOSiteRestrictedAppAccessControl
    -Identity <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

cmdlet을 Enable-SPOSiteRestrictedAppAccessControl 사용하여 단일 사이트에 대한 애플리케이션 제한 적용을 켭니다. 모드가 이미 구성되어 있어야 합니다. Set-SPOSiteRestrictedAppAccessControlMode모드가 설정되지 않으면 cmdlet이 실패합니다.

사이트 적용은 이 cmdlet에서만 활성화됩니다. 구성 및 사용은 독립적입니다. 모드 및 목록 변경 변경 적용이 켜지지 않습니다. 관리자는 다음을 사용하여 정책을 준비한 다음 명시적으로 사용하도록 설정할 수 있습니다 Set-SPOSiteRestrictedAppAccessControlModeSet-SPOSiteRestrictedAppAccessControlList .

활성 모드는 사이트 정책 결정을 결정합니다.

  • 허용 - 허용 목록의 응용 프로그램이 응용 프로그램 제한 검사를 통과하고 다른 모든 관리되는 응용 프로그램은 사이트 정책에 의해 거부됩니다. 활성 허용 목록이 비어 있으면 사이트 정책이 모든 관리되는 타사 및 에이전트 응용 프로그램을 거부합니다.
  • 거부 - 거부 목록에 있는 응용 프로그램이 사이트 정책에 의해 거부되고 다른 모든 관리되는 응용 프로그램이 응용 프로그램 제한 검사를 통과합니다.

비활성 목록은 유지되며 런타임 효과가 없습니다.

테넌트 스위치는 모든 사이트 적용을 게이트합니다. 테넌트 스위치가 꺼져 있는 동안에는 사이트 정책이 적용되지 않으며 사이트 허용 목록으로 테넌트 거부 목록을 재정의할 수 없습니다. 사이트 정책에 의존하기 전에 테넌트 전환을 확인하는 데 사용합니다 Get-SPOTenantRestrictedAppAccessControl .

애플리케이션 제한은 이미 Microsoft Entra 동의 및 SharePoint 권한이 있는 애플리케이션에 대한 SharePoint 권한 부여 경계를 추가합니다. 권한을 부여하지 않으며 Microsoft Entra 동의를 대체하지 않습니다. 요청은 기존 사용 권한 모델과 애플리케이션 제한을 모두 통과해야 합니다.

사이트 응용 프로그램 제한 관리는 범용 Get-SPOSite 및 Set-SPOSite cmdlet과 격리됩니다. 애플리케이션 제한은 에서 Get-SPOSite 완전히 분리되므로 SiteProperties사이트 정책 데이터를 로드하지 않으며 Set-SPOSite 변경할 수 없습니다. 관련 링크에 나열된 전용 애플리케이션 제한 cmdlet을 사용합니다.

Microsoft 자사 및 핵심 애플리케이션은 애플리케이션 제한 구성 및 적용에서 제외됩니다.

SharePoint Online용 Windows PowerShell의 사용 권한과 최신 정보는 SharePoint Online 관리 셸 소개의 온라인 설명서를 참조하세요.

예제

예 1

Enable-SPOSiteRestrictedAppAccessControl -Identity "https://contoso.sharepoint.com/sites/Finance"

이 예제에서는 URL로 식별되는 재무 사이트에 대해 애플리케이션 제한 적용을 설정합니다. 적용은 사이트에 이미 구성된 모드 및 목록을 사용합니다.

예 2

Enable-SPOSiteRestrictedAppAccessControl -Identity "e1b2c3d4-5678-4abc-9def-0123456789ab"

이 예에서는 ID로 식별되는 사이트에 대한 적용을 설정합니다. 모든 사이트 응용 프로그램 제한 cmdlet은 -Identity 사이트 URL 또는 사이트 ID로 수락합니다.

예 3

$url = "https://contoso.sharepoint.com/sites/Finance"
Set-SPOSiteRestrictedAppAccessControlMode -Identity $url -Mode Allow
Set-SPOSiteRestrictedAppAccessControlList -Identity $url -ListType AllowList -AddRestrictedAppIds "11111111-1111-1111-1111-111111111111"
Enable-SPOSiteRestrictedAppAccessControl -Identity $url

이 예에서는 모드 및 허용 목록을 구성한 다음 정책을 명시적으로 사용하도록 설정합니다. 모드 및 목록 변경은 적용을 켜지 않으므로 최종 명령이 실행될 때까지 아무 것도 적용되지 않습니다. 허용 목록의 응용 프로그램은 응용 프로그램 제한 검사를 통과합니다. 다른 모든 관리되는 응용 프로그램은 사이트 정책에 의해 거부됩니다. 기존 Microsoft Entra 동의 및 SharePoint 권한 부여는 계속 적용됩니다.

예 4

Enable-SPOSiteRestrictedAppAccessControl -Identity "https://contoso.sharepoint.com/sites/Finance" -Confirm:$false

이 예에서는 자동화에 사용하기 위해 대화형 확인 프롬프트 없이 적용을 켭니다. 사용 -Confirm:$false 해도 유효성 검사, 권한 부여, 감사 또는 자사 보호가 무시되지 않습니다.

매개 변수

-Confirm

적용 가능: SharePoint Online

cmdlet을 실행하기 전에 확인 메시지를 표시합니다. 이 cmdlet은 , 를 사용 ConfirmImpact.High하므로 기본적으로 프롬프트를 표시합니다. 자동화에서 프롬프트를 표시하지 않는 데 사용합니다 -Confirm:$false .

매개 변수 속성

형식:System.Management.Automation.SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:CF

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Identity

적용 가능: SharePoint Online

사용할 사이트를 지정합니다. 사이트 URL 또는 사이트 ID를 제공합니다.

매개 변수 속성

형식:System.String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-WhatIf

적용 가능: SharePoint Online

cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.

매개 변수 속성

형식:System.Management.Automation.SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:wi

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable과 같은 일반 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

None

출력

None

이 cmdlet은 개체를 반환하지 않습니다. 결과 정책을 읽는 데 사용합니다 Get-SPOSiteRestrictedAppAccessControl .

참고

  • 사이트에서 모드가 구성되지 않은 경우 이 cmdlet은 실패합니다. 정책을 사용하도록 설정하기 AllowDeny 전에 모드를 설정합니다.
  • 사이트 적용은 이 cmdlet에서만 활성화됩니다. 모드 및 목록 변경 내용은 현재 사용 상태를 유지합니다.
  • 활성 허용 목록이 비어 있으면 사이트 정책이 모든 관리되는 타사 및 에이전트 응용 프로그램을 거부합니다. 사이트를 사용하도록 설정하기 전에 활성 목록을 검토합니다.Get-SPOSiteRestrictedAppAccessControl
  • 이 모드에서는 Deny 거부 목록에 표시된 애플리케이션이 사이트 정책에 의해 거부됩니다. 다른 모든 관리 애플리케이션은 애플리케이션 제한 검사를 통과합니다.
  • 테넌트 스위치는 모든 사이트 적용을 제어하므로 테넌트 스위치가 꺼져 있는 동안에는 사이트 정책이 적용되지 않습니다. 테넌트 거부 목록은 사이트 허용 목록으로 재정의할 수 없습니다.
  • 애플리케이션 제한은 사용 권한을 부여하지 않습니다. 요청은 여전히 기존 SharePoint 권한 부여를 통과해야 합니다.
  • 이 cmdlet은 -WhatIf .-ConfirmConfirmImpact.High -Confirm:$false 자동화에 허용되며 유효성 검사, 권한 부여, 감사 또는 자사 보호를 무시하지 않습니다.