Get-SPOSiteRestrictedAppAccessControl

모듈:
Microsoft.Online.SharePoint.PowerShell Module

사용, 활성 모드, 허용 목록 및 거부 목록을 모두 포함하여 사이트에 대한 전체 사이트 수준 애플리케이션 제한 정책을 반환합니다.

구문

Default (기본값) 

Get-SPOSiteRestrictedAppAccessControl
    [-Identity] <String>
    [<CommonParameters>]

Description

cmdlet을 Get-SPOSiteRestrictedAppAccessControl 사용하여 단일 사이트에 대해 저장된 전체 애플리케이션 제한 정책을 읽습니다.

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

사이트 정책은 다음 네 가지 부분으로 구성됩니다.

  • 사용 - 사이트 적용이 켜져 있는지 여부입니다. 사이트 적용은 에 의해 Enable-SPOSiteRestrictedAppAccessControl서만 켜집니다. 모드 및 목록 변경 내용은 구성 전용이며 현재 사용 상태를 유지합니다.
  • 모드 - 활성 모드입니다. 모드Allow가 인 경우 허용 목록의 응용 프로그램은 응용 프로그램 제한 검사를 통과하고 다른 모든 관리되는 응용 프로그램은 사이트 정책에 의해 거부됩니다. 모드가 인 Deny경우 거부 목록의 응용 프로그램은 사이트 정책에 의해 거부되고 다른 모든 관리 응용 프로그램은 응용 프로그램 제한 검사를 통과합니다. 사이트 정책을 사용하도록 설정하기 전에 모드를 명시적으로 구성해야 합니다.
  • AllowList - 모드가 일 때 사용되는 영구 목록입니다.Allow
  • DenyList - 모드 Deny가 일 때 사용되는 영구 목록입니다.

두 목록 모두 항상 저장되며 어떤 모드가 활성 상태인지에 관계없이 관리할 수 있습니다. 활성 모드에서 선택한 목록만 런타임 적용에 참여합니다. 비활성 목록은 향후 모드 변경을 위해 보존되며 런타임 효과가 없습니다. 활성 허용 목록이 비어 있으면 사이트 정책이 모든 관리되는 타사 및 에이전트 응용 프로그램을 거부합니다. 활성 거부 목록이 비어 있으면 사이트 정책에서 해당 목록을 거부하지 않습니다. 기존 Microsoft Entra 동의 및 SharePoint 권한 부여는 계속 적용됩니다.

AllowList GUID DenyList 배열로 반환됩니다. 각 목록에는 구체적인 애플리케이션 ID와 상위 에이전트 청사진 ID가 모두 포함될 수 있으며 청사진 ID는 청사진 응용 프로그램 자체와 해당 청사진에서 생성된 모든 현재 또는 미래의 에이전트 앱에 적용됩니다. 이 cmdlet은 사용자가 둘을 구분할 필요가 없습니다. 각 속성은 내부적으로 입력된 애플리케이션과 청사진 항목을 안정적이고 중복 없는 하나의 GUID 목록으로 병합합니다.

이 cmdlet은 캐시되지 않은 읽기를 수행하고 캐시된 복사본이 아닌 신뢰할 수 있는 저장된 정책을 항상 반환합니다.

사이트 적용은 테넌트 스위치에 의해 열립니다. 테넌트 스위치가 꺼져 있는 동안에는 사이트 정책이 로 보고 Enabled 되는 경우에도 사이트 정책이 적용되지 않습니다.True 테넌트 스위치가 켜져 있는 동안에는 테넌트 거부 목록이 우선하며 사이트 허용 목록으로 재정의할 수 없습니다. 테넌트 전환 및 테넌트 거부 목록을 읽는 데 사용합니다 Get-SPOTenantRestrictedAppAccessControl .

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

Microsoft 자사 및 핵심 응용 프로그램은 응용 프로그램 제한 구성 및 적용에서 제외되며 사이트 목록에 표시되지 않습니다.

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

예제

예 1

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

이 예제에서는 URL로 식별되는 재무 사이트에 대한 전체 애플리케이션 제한 정책을 반환합니다. 반환된 개체에는 다음이 포함됩니다.SiteUrl

예 2

Get-SPOSiteRestrictedAppAccessControl -Identity 8a1e30f6-2f52-4b9e-9d1b-2e9f6c1d40aa

이 예에서는 ID로 식별되는 사이트에 대해 동일한 정책을 반환합니다. 반환된 개체 SiteUrl에는 , 입력이 사이트 ID인 경우에도 결과를 식별할 수 있습니다.

예 3

$policy = Get-SPOSiteRestrictedAppAccessControl -Identity https://contoso.sharepoint.com/sites/Finance
if ($policy.Mode -eq "Allow") {
    $policy.AllowList
} else {
    $policy.DenyList
}

이 예에서는 활성 모드가 적용하는 목록만 반환합니다. 다른 목록은 계속 저장 및 보존되지만 모드를 변경할 때까지 런타임 효과가 없습니다.

예 4

$tenantPolicy = Get-SPOTenantRestrictedAppAccessControl
$policy = Get-SPOSiteRestrictedAppAccessControl -Identity https://contoso.sharepoint.com/sites/Finance
if ($tenantPolicy.Enabled -and $policy.Enabled -and $policy.Mode -eq "Allow" -and $policy.AllowList.Count -eq 0) {
    Write-Host "Enforcement is on with an empty active allow list, which blocks all governed third-party and agentic apps."
}

이 예에서는 테넌트 전환 및 사이트 정책을 사용하도록 설정한 상태, 활성 모드가 , 활성 허용 Allow목록이 비어 있는 상태를 식별합니다. 이 상태에서 사이트 정책은 모든 관리되는 타사 및 에이전트 앱을 차단합니다.

매개 변수

-Identity

적용 가능: SharePoint Online

읽을 사이트를 지정합니다. 사이트 URL 또는 사이트 ID를 지정할 수 있습니다.

매개 변수 속성

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

매개 변수 집합

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

CommonParameters

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

입력

System.String

출력

SPORestrictedAppAccessControlSitePolicy

다음 속성을 가진 개체를 SPORestrictedAppAccessControlSitePolicy 반환합니다.

속성 유형 설명
SiteUrl String 정책이 속한 사이트의 URL입니다. 이 속성은 사이트가 cmdlet에 파이프되거나 입력이 사이트 ID인 경우 결과를 식별할 수 있도록 유지합니다.
Enabled 부울 사이트 적용이 켜져 있는지 여부를 나타냅니다. 사이트 적용은 테넌트 스위치에 의해서도 열립니다.
Mode String 활성 모드 또는 AllowDeny. 이 모드에서 선택한 목록만 적용됩니다.
AllowList 구이드[] 영구 허용 목록은 애플리케이션 ID 및 부모 에이전트 청사진 ID의 안정적이고 중복 없는 하나의 목록으로 반환됩니다.
DenyList 구이드[] 영구 거부 목록은 애플리케이션 ID 및 부모 에이전트 청사진 ID의 안정적이고 중복 없는 목록으로 반환됩니다.

참고

  • 이 cmdlet은 신뢰할 수 있는 캐시되지 않은 정책 상태를 반환합니다.
  • 저장된 정책 데이터의 형식이 잘못된 경우 cmdlet은 경고를 내보내고 반환된 개체 IsPolicyDataMalformed = true에는 . 정상 출력은 해당 속성을 생략합니다.
  • 두 목록 모두 항상 저장됩니다. 활성 모드에서 선택한 목록만 적용됩니다. 비활성 목록은 유지되며 런타임 효과가 없습니다.
  • 각 목록에는 최대 100개의 항목이 있으며 두 목록을 합친 경우 최대 200개의 항목이 있습니다.
  • 부모 에이전트 청사진 ID 항목은 청사진 응용 프로그램 자체와 해당 청사진에서 생성된 모든 현재 또는 미래의 에이전트 앱에 적용됩니다.
  • 테넌트 스위치는 모든 사이트 적용을 게이트합니다. 테넌트 스위치가 켜져 있는 동안에는 사이트 허용 목록으로 테넌트 거부 목록을 재정의할 수 없습니다.
  • 구성 및 사용은 직교입니다. 모드 및 목록 변경 내용 적용이 켜지지 않습니다. 성공하려면 Enable-SPOSiteRestrictedAppAccessControl 모드를 명시적으로 구성해야 합니다.
  • 테넌트 수준 정책을 읽는 데 사용합니다 Get-SPOTenantRestrictedAppAccessControl .